home *** CD-ROM | disk | FTP | other *** search
/ Merciful 2 / Merciful - Disc 2.iso / software / d / datadivisiondoxdisk2.dms / datadivisiondoxdisk2.adf / n&b_oct5.doc < prev    next >
Text File  |  1995-01-31  |  241KB  |  6,386 lines
  1.       ·
  2.       :    ¦    .     _________                 ________       _____________
  3. ._____¦    |         ·   __   / :   ___________/   _    \      \   __  _   /
  4. |     \    |____:    :     \_/ -A : \______    \    |    \_ _:  \_/     \_/
  5. |      \   ¦    |    ¦      \_  ··D_  /   /   _/    |     /  |___/       \_
  6. |    :     :    |    |_______/  `N· _/    \    \_________/   |   \________/
  7. ¦    |_____¦    ¦    |           :  \__________/      \      ¦    \_
  8. :    :    \__________|                                 \___________/
  9. .    ·                          
  10.      .                       »»»» PRESENTS ««««
  11.                                  OCTAMED V5
  12.                                  ==========
  13.  
  14.                                                 TYPED BY SHARD
  15.  
  16.  
  17.  
  18. Written  by  Ed Wiles.  Based on earlier documentation by Teijo Kinnunen and
  19. Larry McIntire (thanks guys!!).
  20.  
  21. Proof-reading  and  minor  alterations by David Wiles, Teijo Kinnunen, Bryan
  22. Williamson and Ray Burt-Frost (the latter of RBF Software) - thank you!
  23.  
  24.  
  25. Contents  (revised for OctaMED V5.01b)
  26. --------------------------------------
  27.  
  28. Welcome to the OctaMED help system. The following topics are available:
  29.  
  30. Introduction            
  31. Those upgrading from V4.
  32. The user interface     
  33. Installation           
  34. Menus                  
  35. Windows                
  36. Main screen            
  37. Player commands        
  38. Keyboard shortcuts      
  39.  
  40.  
  41. "Commodore-Amiga & ppguide Copyright notice"
  42. Amiga Workbench 2.1 is a registered trade mark of Commodore-Amiga inc.
  43.  
  44. (c) Copyright 1985 - 1992 Commodore-Amiga, inc. All Rights Reserved.
  45.  
  46. "Amiga/Workbench/Kickstart are registered trademarks.  Commodore-Amiga,inc."
  47. The  Files  on  the  disk are from WB 2.1 "tm" and are distributed with this
  48. OctaMED  program  under  licence from Commodore themselves.  They may not be
  49. copied and sold without obtaining a licence from CBM
  50.  
  51. The  special  decrunch  prog  that  is being used on this disk to enable the
  52. AmigaGuide  files  to be read from the crunched format is called ppguide and
  53. is used with kind permission of it's author Bill Sorensen.
  54.  
  55. Why on earth didn't C= release the AmigaGuide with PP compatability??
  56.  
  57.  
  58. OctaMED Menus
  59. -------------
  60.  
  61. The OctaMED menu bar contains the following menus:
  62.  
  63. Project
  64. Display  
  65. Song     
  66. Block    
  67. Track   
  68. Instr  
  69. Edit 
  70. MIDI 
  71. Settings 
  72.  
  73. The Project Menu
  74. ----------------
  75.  
  76. New
  77. This  item  displays  the New Project window, with which you may discard the
  78. current project and begin a new one.
  79.  
  80. Open
  81. Displays  a  file requester to load a new song into memory.  The The current
  82. song  will  be  discarded.    A confirmation requester, offering to save the
  83. current  song  first,  will  appear  if the current project has been changed
  84. since last saving.
  85.  
  86. When  loading  songs  without  instruments,  a  requester  will appear if an
  87. instrument  can't be located on disk, offering to continue loading the other
  88. instruments  or  to stop loading the song altogether.  If you continue until
  89. the  song  is  loaded, OctaMED will load the instruments it can find and put
  90. the  names of the instruments it can't find in their proper numbered places.
  91. You  must then locate and load appropriate instruments into these positions;
  92. otherwise, the notes played by those instruments will be silent.
  93.  
  94. Note  that  although  you  can  load  normal Tracker modules, you can't load
  95. packed  Tracker  modules.   Tracker player commands will be converted to the
  96. OctaMED equivalent.
  97.  
  98. If  a song isn't identified as any format listed in the Save Options window,
  99. a  requester will appear wondering if you wish to try to load the file as an
  100. old  Soundtracker  song.    If it IS an old Soundtracker song it should load
  101. correctly, but if not OctaMED may crash!  You have been warned ;-D
  102.  
  103. Upon successful loading, the song's annotation text (if any) is displayed on
  104. the title bar: see Song menu -> Set Annotation.
  105.  
  106. Save
  107. Brings  up  the  Save  Options  window,  with which you can save the current
  108. project on to disk.
  109.  
  110. Save Timer
  111. Opens  the  Save  Timer  window,  which  provides  an  option similar to the
  112. "automatic save" function in many wordprocessors.
  113.  
  114. Delete Files
  115. Displays a file requester allowing you to delete one or more files from disk
  116. (after  confirmation).  TAKE CARE: THE FILES WILL BE PERMANENTLY ERASED FROM
  117. THE DISK!
  118.  
  119. Print
  120. Brings  up the Print Options window, where you may print the current song in
  121. various ways.
  122.  
  123. Last Message
  124. Displays  the  last  message  (error  or  information)  that appeared on the
  125. screen's title bar.
  126.  
  127. About
  128. Displays information about OctaMED.
  129.  
  130. Quit OctaMED
  131. Quits the program.  Will display a confirmation requester if the project has
  132. been changed since last saving.
  133.  
  134.  
  135. The Display Menu
  136. ----------------
  137.  
  138. Tracker Editor
  139. Displays the Tracker editor.
  140.  
  141. Notation Editor
  142. Displays the notation editor.
  143.  
  144. Synth Editor
  145. Opens the Synthetic Sound Editor.  [ Keyboard shortcut: Left Alt-Y ]
  146.  
  147. Sample Editor
  148. Opens the Sample Editor.   [ Keyboard shortcut: Left Alt-E ]
  149.  
  150. Sample List Editor
  151. Opens the Sample List Editor.
  152.  
  153. MIDI Message Editor
  154. Opens the MIDI Message Editor window.
  155.  
  156. Input Map Editor 
  157. Opens the Input Map Editor window.
  158.  
  159. Notation Control
  160. Opens the Notation Control window.  Useful if, while working in the notation
  161. editor, you have closed this window to relieve "cluttering".
  162.  
  163.  
  164. The Song Menu
  165. -------------
  166.  
  167. Select
  168. Opens  the  Song Selector window, with which you may select the current song
  169. (of a multi-module).
  170.  
  171.           [ Keyboard shortcut: Left Alt-G ]
  172.  
  173. Add New
  174. Creates a new song, and appends it as the last song.
  175.  
  176.           [ Keyboard shortcut: Shift-Ctrl-NM) ]
  177.  
  178. Delete Last
  179. Deletes the last song of a multi-module.  Has no effect if there is only one
  180. song in memory.
  181.  
  182.           [ Keyboard shortcut: Shift-Ctrl-NM( ]
  183.  
  184. Playing Sequence
  185. Opens the Playing Sequence window.
  186.  
  187.           [ Keyboard shortcut: Left Alt-Q ]
  188.  
  189. Section List
  190. Opens the Section List window.
  191.  
  192.           [ Keyboard shortcut: Left Alt-C ]
  193.  
  194. Set Options
  195. Opens  the  Song Options window.  This window contains several song-specific
  196. options.
  197.  
  198. Set Volumes
  199. Opens  the  Track  Volumes  window,  which is used to set the volumes of the
  200. tracks relative to the volumes of the notes in the song.
  201.  
  202. Set Annotation
  203. Opens  a  window  containing a single text box.  In this box you may type in
  204. any  text  up to 70 characters long.  This text will be saved with the song,
  205. then  displayed  on  the  title  bar  when  the  song is reloaded.  Suitable
  206. annotation  text  is, for example, a copyright message, the composer's name,
  207. or special instructions.
  208.  
  209.  
  210. The Block Menu
  211. --------------
  212.  
  213. New/Insert
  214. Inserts a new block at the current block position.  OctaMED will correct the
  215. entries  in the playing sequence, so the song isn't changed.  The length and
  216. width of the newly-created block will be taken from the current block.
  217.  
  218.      [ Keyboard shortcut: Ctrl-I ]
  219.  
  220. New/Append
  221. Adds  a  new block after the last block.  The length and width will be taken
  222. from the current block.
  223.  
  224.      [ Keyboard shortcut: Ctrl-N ]
  225.  
  226. New/Insert Def
  227. As  Insert,  but  uses  the  built-in default length/width (64 lines, 4 or 8
  228. tracks - 8 tracks if the channel mode is 5 - 8-channel: see Song Options.
  229.  
  230.      [ Keyboard shortcut: Shift-Ctrl-I ]
  231.  
  232. New/Append Def
  233. As Append, but uses the built-in defaults described above.
  234.  
  235.      [ Keyboard shortcut: Shift-Ctrl-N ]
  236.  
  237. Delete
  238. Deletes  the  block  selected  by  the sub-menu (Current or Last).  WARNING:
  239. There  is  no  confirmation  requester!    OctaMED  corrects the appropriate
  240. playing sequence entries.
  241.  
  242. Set Properties
  243. Opens  the  Block  Properties  window,  which  contains  some block-specific
  244. settings.
  245.  
  246. Block List
  247. Opens  the Block List window.  This window allows easy management of blocks.
  248.  
  249.       [ Keyboard shortcut: Left Alt-B ]
  250.  
  251. Highlight
  252. Opens  the  Highlight Options window, where you may highlight the lines in a
  253. block in a particular order.
  254.  
  255. Cut
  256. Copies the current block to the copy buffer, and clears the block.
  257.  
  258.       [ Keyboard shortcut: Shift-Alt-X ]
  259.  
  260. Copy
  261. Places a copy of the current block in the copy buffer.
  262.  
  263.       [ Keyboard shortcut: Shift-Alt-C ]
  264.  
  265. Paste
  266. Overwrites the block with the copy buffer's contents.
  267.  
  268.       [ Keyboard shortcut: Shift-Alt-V ]
  269.  
  270. Swap w/Buff
  271. Swaps  the  contents  of  the  current  block  with the contents of the copy
  272. buffer.
  273.  
  274. Insert Line
  275. Inserts  a  new  line at the cursor position, increasing the block length by
  276. one line.
  277.  
  278. Delete Line
  279. Deletes  the  line  at the cursor position, reducing the block length by one
  280. line.
  281.  
  282. Expand/Shrink
  283. Opens the Expand/Shrink Block window.
  284.  
  285. Split At Cursor
  286. Splits the current block into two blocks; the current line becomes the first
  287. line of the next block.
  288.  
  289.     [ Keyboard shortcut: Shift-Ctrl-J ]
  290.  
  291. Join With Next
  292. Joins the current block with the following one.
  293.  
  294.     [ Keyboard shortcut: Ctrl-J ]
  295.  
  296. The Track Menu
  297. --------------
  298.  
  299. Cut
  300. Copies  the  current  track  to the copy buffer, and clears the track.  (The
  301. "current track" is the track that the cursor is on).
  302.  
  303. Copy
  304. Places a copy of the current track in the copy buffer.
  305.  
  306. Paste
  307. Overwrites the track with the copy buffer's contents.
  308.  
  309. Swap w/Buff
  310. Swaps  the  contents  of  the  current  track  with the contents of the copy
  311. buffer.
  312.  
  313. Insert Empty
  314. Inserts  an  empty  track.  Tracks on the right of the current track will be
  315. shifted  right.    The  number  of tracks doesn't increase, so the rightmost
  316. track will be discarded.
  317.  
  318. The  sub-menu  allows you to apply the operation to either the current block
  319. only or the entire song.
  320.  
  321.    [ Keyboard shortcut: Curr. Block = Alt-Shift-Backspace ]
  322.  
  323. Delete
  324. Deletes  a  track.  Tracks on the right of the current track will be shifted
  325. left.   The sub-menu allows you to apply the operation to either the current
  326. block only or the entire song.
  327.  
  328.     [ Keyboard shortcut: Curr. Block = Alt-Backspace ]
  329.  
  330.  
  331. The Instr Menu
  332. --------------
  333.  
  334. Set Parameters
  335. Opens  the  Instrument  Parameters  window, which allows you to edit various
  336. instrument parameters.
  337.  
  338.      [ Keyboard shortcut: Left Alt-I ]
  339.  
  340. Type
  341. Opens the Instrument Type window.
  342.  
  343.      [ Keyboard shortcut: Left Alt-T ]
  344.  
  345. Load Instrument(s)
  346. Opens  a  file  requester to load instruments into memory.  OctaMED can load
  347. any  type of instrument listed in Instrument Type.  The instrument is loaded
  348. into  the  sample  slot  displayed  in  the  upper screen.  If an instrument
  349. already exists in that slot, the new one will replace it.
  350.  
  351. If the instrument is a sample or synthetic sound, the title bar displays its
  352. size  in  bytes.   In the case of synthetic sounds, it will also display the
  353. number of waveforms the sound uses.
  354.  
  355. If  more  than  one instrument is selected, they are loaded into consecutive
  356. sample slots in alphabetical order.
  357.  
  358. Save Instrument
  359. Opens a file requester to save the current instrument instrument on to disk.
  360. The sub-menu gives you the choice of saving as an IFF 8SVX file or as a pure
  361. binary  file  (Raw).    The  difference  is that IFF files also contain loop
  362. information  (making  them  slightly  larger than Raw files): see Instrument
  363. Parameters.  Also, some other music programs can only load IFF files.
  364.  
  365. When  saving  synthetic  or hybrid sounds, you may choose either IFF 8SVX or
  366. Raw (since they are saved as neither!).  For ExtSamples, save as IFF 8SVX.
  367.  
  368.     [ Keyboard shortcuts: IFF = Ctrl-S, Raw = Shift-Ctrl-S ]
  369.  
  370. Flush Current
  371. Removes the current instrument from memory, frees the memory used by it, and
  372. clears all its parameters.
  373.  
  374.     [ Keyboard shortcut: Ctrl-G ]
  375.  
  376. Flush All Unused
  377. Removes  all instruments unused by the current project (after a confirmation
  378. requester).  If there are no unused instruments, no requester appears.
  379.  
  380.     [ Keyboard shortcut: Shift-Ctrl-G ]
  381.  
  382. Automatic Flush
  383. When  selected,  a  requester  to  flush  unused  instruments will appear on
  384. pressing the Clear Current button in the New Project window.
  385.  
  386. The  following  two  items  affect  instrument  names  when loading songs or
  387. instruments.
  388.  
  389. Add Path
  390. Adds  the  full path of the instrument when loaded.  (The "path" is the disk
  391. and  directory  name,  for  example: "Samples1:Bass/").  This is useful when
  392. saving  songs  without  instruments  which  include  instruments not in your
  393. sample list.  When the song is reloaded, the instruments will be loaded from
  394. the given disks.
  395.  
  396. Remove Path
  397. Usually  songs  made  with  Trackers have instrument names which include the
  398. full  path.   This option removes the paths of the instruments, so that they
  399. can be loaded using the sample list instead of directly from the appropriate
  400. disk.
  401.  
  402. Both  Add and Remove Path may be active at once.  In this case, the original
  403. path  is  removed,  the  instrument is loaded using the sample list, and the
  404. path name from the sample list is added.
  405.  
  406. Note  that  the  maximum  length  of an instrument name is 40 characters, so
  407. characters at the end of the name may be lost if the path is very long.
  408.  
  409.  
  410. The Edit Menu
  411. -------------
  412.  
  413. Apart from Transpose, all items in this menu act on the current range, which
  414. is selected by dragging the mouse in the Tracker editor.
  415.  
  416. (The button used to drag is defined in the Mouse Options window.
  417.  
  418. Cut Range
  419. Copies the range to the copy buffer, and clears the track.
  420.  
  421.     [ Keyboard shortcut: Ctrl-X ]
  422.  
  423. Copy Range
  424. Places a copy of the range in the copy buffer.
  425.  
  426.     [ Keyboard shortcut: Ctrl-C ]
  427.  
  428. Paste Range
  429. Inserts the contents of the copy buffer at the cursor position.
  430.  
  431.     [ Keyboard shortcut: Ctrl-V ]
  432.  
  433. Paste To Selected Tracks
  434. As  Paste  Range,  but  inserts  consecutive  tracks  in  the copy buffer to
  435. consecutive selected tracks in the block.
  436.  
  437. For  example,  imagine  the  copy buffer contains 3 tracks, the cursor is on
  438. track  2,  and tracks 2, 5 and 8 are selected.  Choosing Paste to Sel Tracks
  439. pastes  the  copy buffer to tracks 2, 5 and 8 (instead of 2, 3 and 4 as with
  440. normal Paste).
  441.  
  442. Tracks  in  the  block are selected by setting the cycle gadget on the upper
  443. screen to "Select".
  444.  
  445.    [ Keyboard shortcut: Shift-Ctrl-V ]
  446.  
  447. Erase Range
  448. Clears the notes in the range.
  449.  
  450.    [ Keyboard shortcut: Ctrl-Z ]
  451.  
  452. Discard Copy Buffer
  453. Flushes the copy buffer and frees the memory it occupied.
  454.  
  455. Transpose
  456. Opens  the Transpose window, which allows transposing and changing of notes,
  457. and changing of instrument numbers.
  458.  
  459. Range Current Track
  460. Ranges the whole of the track the cursor is on.
  461.  
  462.     [ Keyboard shortcut: Ctrl-B ]
  463.  
  464. Range Current Block
  465. Ranges the whole of the current block.
  466.  
  467.     [ Keyboard shortcut: Shift-Ctrl-B ]
  468.  
  469. Spread Notes
  470. Opens  the  Spread  Notes window, which allows spreading of the notes in the
  471. range across consecutive tracks to the right of the range.
  472.  
  473. Pitch Slide
  474. Creates  a  pitch slide, starting from the cursor position and ending at the
  475. next note encountered in the current track.
  476.  
  477. The  sub-menus  select which sliding command to use (see Commands 0 - 9, but
  478. the better result is usually achieved using Type 1.  (The difference is that
  479. type  2  replays the note after sliding to it, whereas type 1 doesn't replay
  480. the note).
  481.  
  482.     [ Keyboard shortcuts: Type 1 = Ctrl-T, 2 = Shift-Ctrl-T ]
  483.  
  484. Volume Slide 
  485. Creates  a  volume  slide, with the cursor position between the starting and
  486. ending volume commands (that is, the "0C" commands: see Commands A - F.
  487.  
  488.     [ Keyboard shortcut: Ctrl-O ]
  489.  
  490. Generic Slide
  491. Creates  a  slide  using  any  type  of player command.  Position the cursor
  492. somewhere  between  the  starting  and ending commands before selecting this
  493. function.
  494.  
  495. NOTE:  If you want to create a volume slide, this command will do it just as
  496. well  as  the Volume Slide function above.  However, in Decimal Volumes mode
  497. the  slide will be created in hexadecimal, which is bound to cause problems.
  498. So for volume slides, use Volume Slide!   :^)
  499.  
  500. One  use of Generic Slide is to repeat a single player command several times
  501. throughout a track.  Just make the starting and ending commands identical.
  502.  
  503.      [ Keyboard shortcut: Shift-Ctrl-O ]
  504.  
  505. Note Echo
  506. Opens the Note Echo window, which can produce echoes automatically using the
  507. 0C command.
  508.  
  509.  
  510. The MIDI Menu
  511. -------------
  512.  
  513. OctaMED  can  output  notes  and  some player commands (see MIDI Commands to
  514. external  MIDI  devices, by way of a MIDI interface which you should connect
  515. to  your Amiga's serial port.  This menu contains the required functions and
  516. settings for MIDI operation.
  517.  
  518. You  also  need  to  set  the  MIDI  channel  and preset number of each MIDI
  519. instrument,  using  the  Instrument  Parameters  window.   (This window also
  520. contains the "Suppress NoteOff" gadget used with some MIDI instruments).
  521.  
  522. You  may  use  MIDI  instruments  on  any  track, and you may also mix Amiga
  523. samples and MIDI instruments on the first four tracks.
  524.  
  525. Note: 
  526. Please  refer  to your MIDI device's manual if you come across terms in this
  527. topic that you aren't sure of.
  528.  
  529. MIDI Active
  530. Activates  MIDI  when selected.  If the serial port is being used by another
  531. program,  however, you must quit the other program before you can use MIDI. 
  532. When  this  option  is on, an "M" appears in the display box to the right of
  533. Cont Block in the upper screen.
  534.  
  535. Input Active
  536. When  selected,  allows  the  entering of notes into the song using the MIDI
  537. device.    Edit  mode  and  MIDI  Active  must be on.  An "I" appears in the
  538. display box mentioned above when this function is active.
  539.  
  540. You  can  also  use  your MIDI device to both enter samples and perform many
  541. editing functions using the input map editor.
  542.  
  543. Input Channel
  544. Opens  up  the  Input  Channel window, with which you may set the MIDI input
  545. channel.
  546.  
  547. Ext Sync and Send Sync
  548. Synchronization  (or  "sync" for short) involves OctaMED sending information
  549. which allows MIDI devices to keep in time with OctaMED.
  550.  
  551. When  "Send  Sync"  is  activated,  this  information is sent when you click
  552. either Play Song or STOP (not Cont Song, Play Block or Cont Block).
  553.  
  554. When  "Ext  Sync"  is activated, OctaMED can be synced "externally", meaning
  555. that  an external MIDI device sends the sync information instead of OctaMED.
  556. As  well  as  (of course) "MIDI Active", "Input Active" must be selected for
  557. Ext Sync to work.
  558.  
  559. Send Active Sensing
  560. After  "MIDI  Active"  has been selected, OctaMED periodically sends "active
  561. sensing" ($FE) messages when this is turned on.  These messages tell OctaMED
  562. whether all required MIDI leads are properly connected.
  563.  
  564. Send Out Input
  565. When  activated,  OctaMED  replays input MIDI notes.  Useful for owners of a
  566. separate sound module and keyboard.
  567.  
  568. Read Key-Up's
  569. When  switched  on,  OctaMED  records  key-up events (as 0FFF commands - see
  570. Commands A - F.
  571.  
  572. Read Volume
  573. If  you have a touch-sensitive keyboard, the volume will be entered as a set
  574. volume  player  command  (0C) when notes are input (see Commands A - F.
  575.  
  576. Reset Pitch/Presets
  577. Resets  pitchbenders,  modulation  wheels  and  presets   on   all channels.
  578. (OctaMED sends "preset change" messages for all MIDI channels).
  579.  
  580.      [ Keyboard shortcut: Ctrl-Space ]
  581.  
  582. Send MIDI Reset
  583. Sends a "MIDI Reset" message ($FF).
  584.  
  585. Send Local Control
  586. Sends  a  "Local  Control  On  /  Off"  message.    When  using   a keyboard
  587. synthesizer, the local control (when on) routes the keyboard directly to the
  588. internal  synthesizer.   In a multi-timbral setup, switch local control off;
  589. otherwise, it's usually best to keep on.
  590.  
  591. Note Killing
  592. Selects the method for turning off all notes (by clicking "STOP" or pressing
  593. the space bar).
  594.  
  595. "$Bx  7B  00"  sends "All Notes Off" messages for each MIDI channel, whereas
  596. "Note Off Msgs" sends standard "Note Off" messages for each track.
  597.  
  598. The  former  is recommended if your MIDI device supports it, because it cuts
  599. all notes, not just those OctaMED triggers.
  600.  
  601. (Also see the MIDI Message Editor
  602.  
  603.  
  604. The Settings Menu
  605. -----------------
  606.  
  607. Mouse Options
  608. Displays  the  Mouse Options window, which allows you to change the function
  609. of each mouse button when editing.
  610.  
  611. Keyboard Options
  612. Displays  the  Keyboard  Options  window,  which contains several parameters
  613. concerning using the keyboard when editing.
  614.  
  615. Programmable Keys
  616. Opens the Programmable Keys window, where you may edit the programmable keys
  617. (Shift-0-9).
  618.  
  619. Display Max Tracks
  620. Selects  the  maximum  number  of  tracks that can be displayed on-screen at
  621. once.    The value that you select depends mostly on your eyesight!  To find
  622. the  appropriate  value for you, set the "Tracks" slider in Block Properties
  623. to  17  or  above, and pick 4, 8 and 16 from Display Max Tracks in turn.  If
  624. you  connect  your  Amiga to a television and you can still clearly read the
  625. block contents in 16 mode, your eyesight is truly remarkable!
  626.  
  627. (You  may notice that in 16 mode, 17 tracks are in fact displayed at once...
  628. don't ask me why ;-)
  629.  
  630. Palette
  631. Opens the Palette Window, with which you can alter the screen's colors.
  632.  
  633. Equalizers
  634.  Selects  which  "equalizers" to display.  (They aren't actually equalizers,
  635. but  this  is  their  popular name).  They're useful as a quick check to see
  636. which  track  is  playing, or to monitor rhythm.  "Bar" toggles the colorful
  637. sprites,  "Oscilloscope"  toggles  the  signal displays at the bottom of the
  638. screen.
  639.  
  640. The  equalizers  are  disabled  during  disk activity and if any windows are
  641. open.
  642.  
  643. Under  a  68000  processor, the Oscilloscopes in particular take up a lot of
  644. processor  time  (multi-tasking becomes poorer, disk activity noisier etc.),
  645. so  if you have a 68000 you may wish to disable them permanently.  Under all
  646. processors, they are disabled during disk activity.
  647.  
  648. Workbench
  649. Attempts to open / close the Workbench.  Useful if you are low on memory, as
  650. closing the Workbench frees about 40K of chip memory.
  651.  
  652. H -> B
  653. Selects  how OctaMED will display the name of the note between A# and C.  In
  654. some  countries  it's  H,  in  others  it's B.  When set, B's are displayed.
  655. Default is on (B's are displayed).
  656.  
  657. Play After Loading
  658. When  set,  OctaMED  automatically starts playing a song after it is loaded.
  659. Useful, for example, when listening to other people's songs.
  660.  
  661. Auto-Freeze Screen
  662. When  on, this automatically "freezes" the screen when the OctaMED screen is
  663. not  the  frontmost.   This frees more processor time for multitasking.  The
  664. screen  can  also  be  frozen  using  the Freeze Display gadget in the lower
  665. screen.
  666.  
  667. Load Settings
  668. Opens  a  file  requester  to load a new settings file.  The default name is
  669. "S:OctaMEDPro.config".
  670.  
  671. Save Settings
  672. Saves  the  current  settings under the name "S:OctaMEDPro.config".  OctaMED
  673. will attempt to load a file of this name on startup.
  674.  
  675. Save Settings As
  676. Opens a file requester to save the settings under a non-default name.
  677.  
  678. For a list of the settings saved with the config file, see the Settings File
  679.  
  680.  
  681. OctaMED Windows
  682. ---------------
  683.  
  684. These are the windows included in OctaMED.
  685.  
  686. Synthetic Sound Editor:           Block menu  :
  687. Synthetic Sound Volume            Block Properties
  688. Synthetic Sound Stretch           Block List 
  689.                                   Expand/Shrink Block
  690. Sample Editor                     Highlight Options
  691.  
  692. Change Volume                     Instr menu  :
  693. Change Pitch 
  694. Mix                               Instrument Parameters
  695. Filter/Boost                      Instrument Type
  696. Echo
  697. Noise                             Edit menu  :
  698. Chord Creation 
  699. Pixel Density                     Transpose
  700.                                   Spread Notes
  701. Input Map Editor                  Note Echo
  702.  
  703. Functions                         MIDI menu  :
  704.  
  705. Project menu  :                              Input Channel
  706.  
  707. New Project                       Settings menu  :
  708. Save Options
  709. Save Timer                        Mouse Options
  710. Print Options                     Keyboard Options 
  711.  
  712. Programmable Keys
  713.  
  714. Display menu  :                   Palette
  715.  
  716. Sample List Editor                Main screen  :
  717. MIDI Message Editor
  718. Notation Control                  Instrument Load
  719.  
  720. Song menu  :
  721.  
  722. Song Selector   
  723. Playing Sequence
  724. Section List  
  725. Song Options   
  726. Track Volumes   
  727.  
  728. The New Project Window   [ Keyboard shortcut: Amiga-N ]
  729.  
  730. With  this  window you can discard the current project and begin a new one. 
  731. It is activated via the Project menu.
  732.  
  733. If  the  current  project  has been modified since last saving, the window's
  734. title  bar  will  display "WARNING: Current project modified!".  This is the
  735. only warning you are given: no confirmation requesters are displayed.
  736.  
  737. It contains three gadgets:
  738.  
  739. Clear All
  740. Discards all samples and songs.
  741.  
  742. Clear Current
  743. Clears  the current song only.  If Instr Menu/Automatic Flush is selected, a
  744. requester to flush unused instruments will also appear.
  745.  
  746. Cancel
  747. Closes the window, canceling the operation.
  748.  
  749.  
  750. The Save Options Window   [ Keyboard shortcut: Amiga-S ]
  751.  
  752. This window allows you to save the current project on to disk.  It is opened
  753. using the Project menu.
  754.  
  755. The  text  box at the top of the window is for typing in the filename of the
  756. project.    If  the  box  is  empty  on opening the window, a file requester
  757. appears  to  select an appropriate filename.  The file requester can also be
  758. opened by clicking the small GetFile gadget to the left of the text box.
  759.  
  760. The  cycle gadget under the File Format gadget applies to multi-modules, and
  761. selects  whether  to  save  all  the  songs  in the multi-module or only the
  762. currently selected song.  By default, all songs are saved.
  763.  
  764. File Format
  765. This  radio  button  selects  which file format to use when saving.  Options
  766. are:
  767.  
  768. MMD2 (OctaMED V5)
  769. This format is new to V5, and supports multiple playing sequences (sections)
  770. and  1  -  64  tracks.   If the song requires either of these features, this
  771. gadget is selected when the Save Options window is opened.
  772.  
  773. MMD1 (OctaMED V3-V5) 
  774. This  is the V3-V5 format, so is (of course) compatible with these versions.
  775. If  MMD2 format is not required, this gadget is selected on opening the Save
  776. Options window.
  777.  
  778. Modules  requiring  MMD2  format  can  be saved almost perfectly under MMD1.
  779. Song sections are the only thing not saved: instead, they are converted into
  780. one  long  playing  sequence,  by  ordering  the sections in the arrangement
  781. defined by the section list.
  782.  
  783. MMD0 (MED & OctaMED) 
  784. The  pre-OctaMED  V3 format, introduced in MED V2.10.  Files saved with this
  785. format lack the following:
  786.  
  787. * 2-digit commands (the first digit is always zero)
  788. * Notes above D-6 (replaced by a -|- symbol)
  789. * Block names
  790. * Line highlighting
  791.  
  792. MMD0  modules  are  always  saved  with  instruments,  and song sections are
  793. converted as described above.
  794.  
  795. Note  that  even  options  new to V5 (Loop On check box, ExtSamples, default
  796. pitch,  extended  MIDI  preset, 1 - 64 tracks) are properly saved under MMD1
  797. and  MMD0.  (Although 1 - 64 tracks are correctly saved under MMD1, however,
  798. pre-V5  versions of OctaMED will probably crash if such modules are loaded).
  799.  
  800.  
  801. Tracker Module
  802. Sound/Noise/Protracker  format,  used  to  export modules to other "tracker"
  803. programs.    However, since OctaMED supports many functions that trackers do
  804. not, some information may be lost, and some of this information appears in a
  805. requester before saving.
  806.  
  807. Full  details  of the lost information can be found in Tracker Modules.
  808.  
  809. The  further  down  the  File  Format  button you go, the simpler the format
  810. becomes,  and  therefore  the smaller the file produced.  So for example, if
  811. you  don't  require  notes  above  D-6, block names, line highlighting, song
  812. sections  or  two-digit  commands  to  be  saved, you should choose the MMD0
  813. format, since it produces a smaller file than MMD1 or MMD2.
  814.  
  815. Save Secondary Data
  816. Toggles whether to save "extra" information with the song: instrument names,
  817. line  highlighting, block names, and the song name.  Otherwise, only what is
  818. essential to play the song is saved (meaning that the saved file is slightly
  819. smaller).
  820.  
  821. Create Icon
  822. When  selected,  a  Workbench  icon  file is saved with the song: a cassette
  823. image  (designed  by Izrael Similä of Iz Productions, thanks!).  The default
  824. tool is written as "OctaMEDPlayer".
  825.  
  826. Save Notation Data
  827. When checked, saves some additional information used in the notation editor:
  828.  
  829. * The Shown, Ghost and Select track gadgets' status
  830. * The time and key signature
  831. * Both the settings in the Instr. Notation window
  832.  
  833. Save Instruments
  834. Chooses  whether the song should be saved together with its instruments.  If
  835. not,  only  the  instrument  names are saved; when the song is reloaded, the
  836. instruments are loaded from your sample disks.  This is done either by using
  837. the  full  path  name  of each instrument (see (see Instr Menu/Add Path), or
  838. more commonly by way of the sample list.
  839.  
  840. When this gadget is on, instruments unused in the song won't be saved.
  841.  
  842. By default, all these check boxes except Save Notation Data are switched on.
  843.  
  844.  
  845. To  those upgrading from V4: MMD1 and MMD0 are equivalent to MOD1 and MOD0. 
  846. MOD1  (+instr)  can  be  selected  by  choosing  MMD1   and   switching Save
  847. Instruments on, and MOD1 (no inst) by switching Save Instruments off.
  848.  
  849. Compression
  850. This  cycle gadget selects the compression (if any) to use before saving the
  851. module.
  852.  
  853. No Compression
  854. Does not compress the module (default).
  855.  
  856. PowerPacker Compression
  857. Uses  the  popular  powerpacker.library  by   Nico   François   to compress.
  858. (Currently the parameters are always Good efficiency, Medium buffer).
  859.  
  860. SFCD Compression
  861. The  Stephan  Fuhrmann  Compact  Density  algorithm  is used for compression
  862. (requires lh.library, not included with OctaMED).
  863.  
  864. Calculate Size
  865. Calculates  the  size  in  bytes  of  the  project if it was saved using the
  866. current status of File Format, Save Secondary Data, Save Notation Data, Save
  867. Instruments and the multi-module cycle gadget.
  868.  
  869. Save
  870. Saves the song using the above parameters.
  871.  
  872.  
  873. **  OctaMED can emulate the "automatic save" function of many wordprocessors
  874. using the Save Timer window
  875.  
  876.  
  877. The Save Timer Window 
  878.  
  879. This window, activated using the Project menu, emulates the "automatic save"
  880. function  of  many  wordprocessors.    You  can  automatically open the Save
  881. Options window periodically.
  882.  
  883. The  window  contains  a  single  integer gadget, whose value is the time in
  884. minutes  between subsequent openings of the Save Options window.  A value of
  885. 0 turns this function off, and is the default.
  886.  
  887.  
  888. The Print Options Window   [ Keyboard shortcut: Amiga-P ]
  889.  
  890. This  window, opened using the Project menu, allows printing of the song and
  891. various song information.  You can print the song as text (the format of the
  892. Tracker editor or as graphics (as in the notation editor.
  893.  
  894. The gadgets are as follows:
  895.  
  896. Output File
  897. Consists  of  a  text  box and a GetFile gadget to the left of the text box.
  898. With  these you may redirect output to a file instead of a printer.  You can
  899. only redirect the header and text output, not graphics.
  900.  
  901. Start Block
  902. These numerical boxes set the starting and ending block of the printout; you
  903. may type in any valid block numbers.
  904.  
  905. All Blocks
  906. Sets the boxes to the first and last block of the song.
  907.  
  908. Current Block
  909. Sets the boxes to the current block number.
  910.  
  911. Print Header
  912. Selects  whether  to  print the header before the song contents.  The header
  913. consists  of  a list of instruments and their parameters, the default tempo,
  914. play transpose, track volumes and the playing sequence(s).  It is printed as
  915. ordinary text.
  916.  
  917. Form Feed
  918. Sends a form feed after printing each block.
  919.  
  920. The  remaining  cycle gadget selects whether to print as graphics (default),
  921. text,  or  not  to  print the blocks at all (i.e.  only the header, if Print
  922. Header is checked).
  923.  
  924. Any  Preferences-compatible  printer  should  work in graphics mode, and the
  925. printout's  appearance can be changed using the "Printer" preference program
  926. which can be found in the Prefs drawer.  In text mode, highlighted lines are
  927. printed in bold text.
  928.  
  929. "Print" prints using the specified options, and "Exit" closes the window.
  930.  
  931.  
  932. The Synthetic Sound Editor   [ Keyboard shortcut: Left Alt-Y ]
  933.  
  934. Synthetic  sounds  (or  "synthsounds") are made from simple waveforms, which
  935. can  be  joined  together and have their volume and pitch altered by using a
  936. simple  "programming  language".    This  window  contains  the functions to
  937. construct these sounds, and is opened either by using the Display menu or by
  938. clicking the "Edit SynthS" gadget on the upper screen.
  939.  
  940. The  main advantage of synthsounds is that they take up far less memory than
  941. their sampled counterparts, so often it's worth trying to create a synthetic
  942. version  of  a  sampled  instrument  before  devoting yourself to one or the
  943. other.    However,  this  doesn't  mean  synthsounds  are a poor substitute,
  944. especially if you enjoy the sounds produced by analogue synthesizers and the
  945. good old Commodore 64!
  946.  
  947. Synthsounds are also particularly useful when composing in certain styles of
  948. music,  Acid  House  and  Rave  being notable examples.  They also have a 5-
  949. octave range, compared to the 3-octave range of ordinary samples.
  950.  
  951. To  use this window's functions, the current instrument must be a synthsound
  952. (selected  either  by  using the Instrument Type window, or by choosing "New
  953. Synthsound" from the synth editor's Project menu).
  954.  
  955. When  Edit  is  on  (upper  screen),  the  keyboard  is  used to program the
  956. synthsound  (see  the Synthetic Sound Programming Language, but when off you
  957. may play the current sound using the keyboard, like ordinary samples.
  958.  
  959. Waveform editing
  960. ----------------
  961.  
  962. There  are  two  waveform  displays:  the  left  one is the "master waveform
  963. display"  (which  is the actual current instrument) and the right one is for
  964. intermediate  editing  (it  also  serves  as  a copy buffer).  Either of the
  965. waveforms  can be activated by clicking on them, and the current waveform is
  966. recessed (it seems to "go into" the screen).  Initially the right display is
  967. active.
  968.  
  969. There  are  gadgets  between  the  displays,  most  of  which  are  used for
  970. transferring waveforms between displays:
  971.  
  972. Copy
  973. Copies one waveform to the other (in the arrow direction).
  974.  
  975. Exchange
  976. Exchanges both waveforms.
  977.  
  978. Mix
  979. Mixes the left waveform to the right waveform.
  980.  
  981. Add
  982. Like Mix, but it doesn't produce any average between the waveforms.
  983.  
  984. UNDO
  985. "Undoes" (reverses the effects of) the last editing operation.
  986.  
  987. Range All
  988. Selects the entire current waveform as the range for editing operations.
  989.  
  990.  
  991. Freehand drawing
  992. ----------------
  993.  
  994. One  way  to  create waveforms is to draw them from scratch, by dragging the
  995. left mouse button along a waveform display.
  996.  
  997. There  are  four drawing modes, selectable by toggling the "Draw Mode" cycle
  998. gadgets.
  999.  
  1000. Pixel
  1001. Draws in pixels (default).
  1002.  
  1003. Line
  1004. Used for drawing straight lines.
  1005.  
  1006. Mix
  1007. Mixes the drawn lines / pixels with the existing data.
  1008.  
  1009. Direct
  1010. Draws without mixing (default).
  1011.  
  1012. (The upper cycle gadget also selects Range, with which you can select a part
  1013. of the waveform: see below).
  1014.  
  1015. The Preset and Project menus
  1016. ----------------------------
  1017.  
  1018. Instead  of  drawing  freehand  (which can be inaccurate), some often-needed
  1019. basic  waveforms  are available from the Presets menu.  Selecting a waveform
  1020. inserts it into the active waveform display.
  1021.  
  1022. Also in this menu is "Clear Wave", which clears the active display.
  1023.  
  1024. The following items are included in the Project menu:
  1025.  
  1026. New Synthsound
  1027. Clears  the  whole  synthsound  (take  care...).    Also  forces the current
  1028. instrument to be a synthsound.
  1029.  
  1030. Exit Synth Editor
  1031. Closes the window.
  1032.  
  1033. Waveform length
  1034. ---------------
  1035.  
  1036. Each  synthetic waveform can be 2 - 128 bytes long (although the number must
  1037. be  even).    The shorter the waveform, the higher the pitch (the pitch also
  1038. depends  on the waveform itself).  Usually, to make the pitches harmonically
  1039. compatible with other instruments, you should use length 2, 4, 8, 16, 32, 64
  1040. or 128.  The length can be changed by using the "Length" slider.
  1041.  
  1042. Multiple waveforms
  1043. ------------------
  1044.  
  1045. Up  to  64  waveforms can be defined for one synthsound.  The gadgets to the
  1046. right  of "Waveform:" are: the current waveform integer gadget (you can type
  1047. in  the  number of the waveform), the current waveform number in hex and the
  1048. last  waveform number in decimal, and arrow gadgets that increase / decrease
  1049. the  current waveform number [ keyboard shortcuts: Alt - <left> / <right> ].
  1050. Shift-clicking these arrow gadgets selects the first / last waveform.
  1051.  
  1052. Relevant gadgets are as follows:
  1053.  
  1054. New Waveform
  1055. Adds a new waveform after the last waveform.
  1056.  
  1057. New Here
  1058. Inserts a new waveform at the current waveform position.
  1059.  
  1060. Delete Last
  1061. Deletes the last waveform.
  1062.  
  1063. Delete Current
  1064. Deletes the current waveform.
  1065.  
  1066. Range operations
  1067. ----------------
  1068.  
  1069. Some  basic  operations  exist  that apply to the current range.  A range is
  1070. marked by cycling the upper Draw Mode cycle gadget to "Range", then dragging
  1071. the  left  mouse  button over a waveform display.  The whole waveform can be
  1072. selected  by  clicking  "Range  All".    The  "Range" / "End" gadgets at the
  1073. lower-right of the window can be used to make small corrections to the range
  1074. area.
  1075.  
  1076. A  range of one byte in length is displayed as a single vertical white line.
  1077. This  is  the cursor; some editing operations need it.  It may be set either
  1078. by  clicking  the  left  mouse  button  on  a waveform display (with "Range"
  1079. cycled),  or  by  using  the  "Cursor" gadgets: from left to right, they are
  1080. "cursor to start", "cursor to middle of waveform", and "cursor to end".
  1081.  
  1082. The range gadgets are as follows:
  1083.  
  1084. Cut
  1085. (works  only on left waveform display) Moves the range contents to the right
  1086. display, and clears the range.
  1087.  
  1088. Copy
  1089. (only left display) Copies the range to the right display.
  1090.  
  1091. Paste
  1092. Copies right display to the cursor position on the left display.
  1093.  
  1094. Clear
  1095. Clears the range.
  1096.  
  1097. Double
  1098. "Doubles" the range, making the pitch one octave higher.
  1099.  
  1100. Reverse
  1101. Reverses the range.
  1102.  
  1103. << / >>
  1104. Shifts the ranged data to the left or right.
  1105.  
  1106. The Waveform menu
  1107. -----------------
  1108.  
  1109. Change Volume
  1110. Opens the Synthsound Volume window.
  1111.  
  1112. Stretch
  1113. Opens the Synthsound Stretch window.
  1114.  
  1115. Start / Do
  1116.  
  1117. Transformation
  1118. Allows  you  to  change  one waveform to another smoothly, by generating the
  1119. intervening waveforms.
  1120.  
  1121. For  example,  allocate  9 new waveforms by clicking "New Waveform" 9 times.
  1122. Move  to  waveform  0  and  select  a  pulse  waveform,  and  select  "Start
  1123. Transformation".  Now move to waveform 9 and select a sine waveform.  Select
  1124. "Do  Transformation" to carry out the operation, and if you view waveforms 1
  1125. - 8 you'll notice the smooth transition between the pulse and sine wave.
  1126.  
  1127. (Programming language documented in Synthetic Sound Programming Language
  1128.  
  1129.  
  1130. The Synthsound Volume Window   [ Keyboard shortcut: Amiga-V ]
  1131.  
  1132. This  allows  you  to increase / decrease the volume of a selected range, in
  1133. the  synthetic  sound editor.  It is brought up by selecting "Change Volume"
  1134. from the editor's Waveform menu.
  1135.  
  1136. The  integer  gadget contains the percentage of volume change required.  For
  1137. example,  50  would  halve  the  volume,  and  200 would double the volume. 
  1138. Pressing RETURN while the gadget is active executes the function.
  1139.  
  1140. The OK gadget carries out the operation, the Cancel gadget aborts it.
  1141.  
  1142.  
  1143. The Synthsound Stretch Window   [ Keyboard shortcut: Amiga-S ]
  1144.  
  1145. This allows you to stretch a point on the waveform towards another point, in
  1146. the  synthetic  sound  editor.   It is activated using the editor's Waveform
  1147. menu.
  1148.  
  1149. For  example: select a sine wave.  Then position the cursor at the middle of
  1150. the waveform.  Now open this window and type the amount of movement into the
  1151. integer gadget (e.g.  32).
  1152.  
  1153. Typing  in  a  negative  number  stretches  the point to the left.  Pressing
  1154. RETURN while the gadget is active executes the function.
  1155.  
  1156. The OK gadget carries out the operation, the Cancel gadget aborts it.
  1157.  
  1158.  
  1159. The Synthetic Sound Programming Language
  1160.  
  1161. Note:  Please  read this section carefully before experimenting, because you
  1162. can  lock  your  machine  up with improper use of the synthsound programming
  1163. language (as with any other language).
  1164.  
  1165. The programming language is used for controling the volume, pitch, and order
  1166. of waveforms in a synthsound.  It consists of simple keywords, of which most
  1167. have  an argument.  For a description of these keywords, see Synthetic Sound
  1168. Language Keywords.
  1169.  
  1170. The  programming  is  done using two lists of commands/numbers.  These lists
  1171. are  displayed  in  a  small  window below the right waveform display in the
  1172. synthetic  sound  editor.  The two leftmost columns display the line numbers
  1173. in decimal and hex.  The middle column contains the volume control sequence,
  1174. while the rightmost is the waveform/pitch control sequence.
  1175.  
  1176.        volume ctrl seq
  1177.           |
  1178. line      |    waveform ctrl seq
  1179.   |       |    |
  1180.   00 00   40   00
  1181.   01 01  END  END
  1182.  
  1183. These sequences ("seqs" from now on) are both a maximum of 127 entries long.
  1184. Each seq is always automatically terminated with the "END" instruction.  You
  1185. can scroll the seqs with the cursor up/down keys, and use the F6-F10 keys as
  1186. in the Tracker editor.
  1187.  
  1188. The  cursor  can  be  moved  horizontally using the cursor left/right keys. 
  1189. There  are  six possible horizontal cursor locations (3 for each seq).  When
  1190. entering  commands,  the  cursor  should  be on the leftmost position of the
  1191. appropriate  seq.    Values  are  entered by positioning the cursor over the
  1192. number  to  be  changed and typing in a new value.  Commands and numbers are
  1193. entered  via  the  keyboard,  and  Edit  must be on before either seq can be
  1194. changed.
  1195.  
  1196. You  may  insert entries to the seqs with the Return key (or by clicking the
  1197. "Insert"  gadget),  and delete using the Del key (or by clicking "Delete"). 
  1198. JMP commands are renumbered when entries are inserted or deleted.
  1199.  
  1200.  With the release of V5, editing has been tidied up somewhat.  The cursor no
  1201. longer  moves  down beyond END; and inserting any command except HLT and RES
  1202. (which don't take parameters) also inserts a new 00 value.
  1203.  
  1204. The  "Transition"  gadget  creates  transitions.  For example, consider this
  1205. waveform sequence: line 00 00 01 0F 02 END
  1206.  
  1207. If you position the cursor at line 01, making sure that Edit is on, clicking
  1208. "Transition"  creates all the numbers between 00 and 0F (01, 02, 03, 04 ... 
  1209. 0E).  This saves a lot of typing!
  1210.  
  1211.        * ALL NUMBERS IN THE SEQUENCE LISTS ARE HEXADECIMAL *
  1212.  
  1213. First, let's examine some example sequences.
  1214.  
  1215. This is a volume sequence:
  1216.  
  1217.         00  40 <= set initial volume to 64 (hex $40)
  1218.         01 CHD <= command, that means "Set volume change down speed"
  1219.         02  03 <= argument (speed = 3)
  1220.         03 END
  1221.  
  1222. Here's another:
  1223.  
  1224.         00  00 <= initial volume = 0
  1225.         01 CHU <= Command: Set volume change up
  1226.         02  07 <= speed = 7
  1227.         03 WAI <= Command: Wait
  1228.         04  10 <= wait 10 pulses
  1229.         05 CHU <= Set volume change up
  1230.         06  00 <= speed = 0 -> stop changing volume
  1231.         07 WAI <= Wait
  1232.         08  70 <= 70 pulses
  1233.         09 CHD <= Cmd: Set volume change down
  1234.         0A  01 <= speed = 1 (slow)
  1235.         0B END
  1236.  
  1237. A third:
  1238.  
  1239.         00  40 <= vol = $40
  1240.         01  30 <= vol = $30 (without a command, the values are volume
  1241.         02  20 <= vol = $20  changes)
  1242.         03 END
  1243.  
  1244. And finally, a fourth:
  1245.  
  1246.         00  40    <= vol = $40
  1247.         01 CHD <+ <= change down speed..
  1248.         02  01  | <= ..= 1
  1249.         03 WAI  | <= Wait..
  1250.         04  20  | <= ..20
  1251.         05 CHU  | <= change up
  1252.         06  01  | <= ..1
  1253.         07 WAI  | <= Wait..
  1254.         08  20  | <= ..20 again
  1255.         09 JMP  | <= Jump (= goto)
  1256.         0A  01 -+ <= to line number 01
  1257.         0B END
  1258.  
  1259. Now  for  some waveform/pitch sequences.  The waveform/pitch sequence is the
  1260. "master sequence" while the volume sequence is a kind of "slave sequence".
  1261.  
  1262. First: (the simplest case)
  1263.         00  00 <= set waveform #00
  1264.         01 END
  1265.  
  1266. A bit more complex:
  1267.         00 VBS <= set vibrato speed
  1268.         01  40 <= speed = $40
  1269.         02 VBD <= set vibrato depth
  1270.         03  02 <= depth = 2
  1271.         04  00 <= waveform #00
  1272.         05 END
  1273.  
  1274. And very complex:
  1275.         00 ARP <= start arpeggio sequence
  1276.         01  00 \
  1277.         02  03  arpeggio values 0, 3, 7 (minor chord)
  1278.         03  07 /
  1279.         04 ARE <= end arpeggio sequence
  1280.         05 VBD <= vibrato depth
  1281.         06  06 <= 6
  1282.         07 VBS <= vibrato speed
  1283.         08  40 <= $40
  1284.         09  00 <= set waveform #0
  1285.         0A  01 <= set waveforms 01 - 0A (one timing pulse/waveform)
  1286.         0B  02    | |
  1287.         0C  03   \   /
  1288.         0D  04    \_/
  1289.         0E  05
  1290.         0F  06
  1291.         10  07
  1292.         11  08
  1293.         12  09
  1294.         13  0A and back to #01...
  1295.         14  08
  1296.         15  07
  1297.         16  06
  1298.         17  05
  1299.         18  04
  1300.         19  03
  1301.         1A  02
  1302.         1B  01
  1303.         1C JMP <= jump
  1304.         1D  09 <= to position 09 (restart waveform changing)
  1305.         1E END
  1306.  
  1307.  
  1308. About timing
  1309. ------------
  1310.  
  1311. After  executing  most  commands,  in both control seqs, OctaMED immediately
  1312. executes  the  next  command.  However, with some commands OctaMED waits for
  1313. the  next timing pulse before executing the next command.  Without these few
  1314. commands,  OctaMED  would spend all its time executing the control seqs (and
  1315. hang  up).  You should therefore ensure that all loops contain one, and they
  1316. are  WAI (Wait), vol chg (a plain number in the volume seq) and set waveform
  1317. (a plain number in the pitch/waveform seq).
  1318.  
  1319. For example, the following loops would hang up your computer:
  1320.  
  1321.         00 JMP          00  CHU <-+ command CHU doesn't wait
  1322.         01  00          01   02   |
  1323.         ...             02  JMP   |
  1324.                         03   00 --+
  1325.  
  1326. While the following would not:
  1327.  
  1328.         00  20          00  WAI
  1329.         01 JMP          01   02
  1330.         02  00          02  JMP
  1331.                         03   00
  1332.  
  1333. Execution speed
  1334. ---------------
  1335.  
  1336. The  synthsound  handling  routine  is  by  default called once every timing
  1337. pulse,  so  for  every  note  played  handling  is  done the number of times
  1338. specified by the secondary tempo.  However, you can make OctaMED execute the
  1339. synth control seq entries less frequently than that if you wish.  The number
  1340. of  timing  pulses  between  the  execution  of  each  entry is known as the
  1341. "execution speed".
  1342.  
  1343. The execution speed of each seq can be set independently, by using the arrow
  1344. gadgets  to  the  left  of  the  control  seq.    Wave  and   Volume set the
  1345. waveform/pitch  and  volume  sequences  respectively, and can have values of
  1346. 1-15  (F hex).  The execution speed can also be changed during execution, by
  1347. using the SPD command.
  1348.  
  1349. Synthsound-handling player commands
  1350. -----------------------------------
  1351.  
  1352. With  synthsounds,  command E in songs triggers a jump in the waveform/pitch
  1353. sequence.  (See Commands A - F
  1354.  
  1355. For  example,  if  you  wanted  to  decrease  the pitch of the sound after a
  1356. certain point, your waveform/pitch sequence could look like this:
  1357.  
  1358.         00  VBS
  1359.         01   40
  1360.         02  VBD
  1361.         03   06
  1362.         04   00 ;play waveform 00
  1363.         05  HLT
  1364.         06  CHD ;pitch changing entry point
  1365.         07   02
  1366.         08  END
  1367.  
  1368. Now you could compose a track like this:
  1369.  
  1370.         C-2 3000  ;this is the previous synthsound
  1371.         --- 0000
  1372.         --- 0000
  1373.         --- 0E06  ;cause a jump to position 06 (pitch starts to slide down)
  1374.         --- 0000
  1375.         ...
  1376.  
  1377. Using  the JVS command, you can make command E affect the volume sequence as
  1378. well.
  1379.  
  1380. Hold  and Decay (see Instrument Parameters Window work well with synthsounds
  1381. too.    The  decay  value  with synthsounds, however, triggers a jump in the
  1382. volume control sequence.  At the point when decay normally starts, execution
  1383. will  jump  to  the  entry in the vol ctrl seq specified by the decay value.
  1384. This  means that you can handle the decay in any way you like.  You can also
  1385. make it affect the waveform/pitch seq using the JWS command.
  1386.  
  1387. Example volume control sequence:
  1388.  
  1389.         00  40  ;volume
  1390.         01 HLT  ;end
  1391.         02 CHD  ;decay handling (entry point) -> cause decay
  1392.         03  03
  1393.         04 END
  1394.  
  1395. The decay value for this synthsound should be 2.  The decay values are saved
  1396. and loaded with synthetic sounds.
  1397.  
  1398. Hybrid Sounds
  1399. -------------
  1400.  
  1401. Hybrid  sounds  are  much  like synthsounds, except that instead of waveform
  1402. pieces  a  normal  sample  is used.  All commands of the synthsound handling
  1403. programming  language  can  be  used  with  hybrid  sounds,  except the "set
  1404. waveform"  command:  since  there's only a single waveform, it neither works
  1405. nor is necessary.
  1406.  
  1407. Also,  volume-changing  commands (A, C, D, 5, 6, 1A, and 1B) don't work with
  1408. hybrid  sounds.    (See Player Commands You can, however, add more synthetic
  1409. waveforms for use with the EN1, EN2 or VWF synth commands.
  1410.  
  1411. And finally...
  1412. -------------
  1413.  
  1414. Don't  worry  if  you  don't  understand  synthsounds  at first glance!  The
  1415. language  used  in  this  topic  has been necessarily technical, but read it
  1416. through again...  :)
  1417.  
  1418. Anyway,  you  don't  need  to learn any this information to use synthsounds,
  1419. only to design them.
  1420.  
  1421.  
  1422. The Synthetic Sound Language Keywords
  1423.  
  1424. VOLUME CONTROL SEQUENCE COMMANDS
  1425. ================================
  1426.  
  1427. 1.      Set volume
  1428.         Command: ---
  1429.         Keyboard: --- (key needed to enter the command)
  1430.  
  1431. This  is  the default command (no command identifier).  It sets the absolute
  1432. volume  of  the  synthsound.   It should be 00 - 40.  Note that the relative
  1433. track  volumes are not used in synthsounds (mostly for performance reasons).
  1434.  
  1435.  
  1436.         Example:
  1437.         00  30  <= volume = $30
  1438.         01  10  <= volume = $10
  1439.         ...
  1440.  
  1441. 2.      End sequence
  1442.         Command: END
  1443.         Keyboard: ---
  1444.  
  1445. This  command  terminates  the  volume  control  seq.  It's always there and
  1446. automatically inserted.  You can't insert commands past this one.
  1447.  
  1448. 3.      Set volume change down speed
  1449.         Command: CHD
  1450.         Keyboard: D
  1451.  
  1452. This  command  sets  the  speed at which the volume is decreased each timing
  1453. pulse.    The  volume  starts changing automatically after this command.  To
  1454. stop automatic volume sliding, issue this command with speed 00.
  1455.  
  1456.         Example:
  1457.         00  CHD
  1458.         01   05  <= speed = 5
  1459.         ...
  1460.         10  CHD
  1461.         11   00  <= speed = 0 -> stop sliding
  1462.  
  1463. 4.      Set volume change up speed
  1464.         Command: CHU
  1465.         Keyboard: U
  1466.  
  1467. This command is like CHD, except it sets the volume change up.
  1468.  
  1469. 5.      Wait
  1470.         Command: WAI
  1471.         Keyboard: W
  1472.  
  1473. This command waits for a specified amount of timing pulses (pause).
  1474.  
  1475.         Example:
  1476.         03  WAI
  1477.         04   10  <= wait for 16 ($10) pulses to occur
  1478.  
  1479. 6.      Jump
  1480.         Command: JMP
  1481.         Keyboard: J
  1482.  
  1483. Causes an immediate jump to another volume seq position.
  1484.  
  1485.         Example:
  1486.         05  JMP
  1487.         06   0A  <= jump forward to line 0A
  1488.  
  1489. 7.      Jump waveform sequence
  1490.         Command: JWS
  1491.         Keyboard: Shift-J
  1492.  
  1493. This  command causes a jump in the waveform sequence.  This can be used, for
  1494. example,  to  trigger  a  pitch change at the end of the vol ctrl seq.  Note
  1495. that this DOESN'T cause a jump TO the waveform seq.
  1496.  
  1497.         Example:
  1498.         04  JWS
  1499.         05   0F  <= jump to line 0F in the waveform control sequence
  1500.  
  1501.  
  1502. 8.      Halt
  1503.         Command: HLT
  1504.         Keyboard: H
  1505.  
  1506. This  has  the  same  effect  as command END (halt execution), but it can be
  1507. inserted in the middle of the sequence.
  1508.  
  1509.         Example:
  1510.         03  HLT
  1511.         04   04  <= other code (can be accessed with JMP instruction, for
  1512.         ...         example)
  1513.  
  1514. 9.      Set speed
  1515.         Command: SPD
  1516.         Keyboard: S
  1517.  
  1518. Sets the execution speed.
  1519.  
  1520.         Example:
  1521.         0A  SPD
  1522.         0B   01  <= speed = 1 (fastest)
  1523.         ...
  1524.  
  1525. 10.     One-shot envelope
  1526.         Command: EN1
  1527.         Keyboard: E
  1528.  
  1529. This  command  allows  you to draw the shape of the envelope with the mouse.
  1530. When the end of the envelope is reached, nothing occurs.
  1531.  
  1532.         02   40
  1533.         03  EN1
  1534.         04   05
  1535.  
  1536. Hence  waveform 05 is used as an envelope.  Note that the envelope execution
  1537. starts  on  the  next  interrupt,  so the volume is initialized to $40.  The
  1538. envelope waveform must always be 128 bytes long!!
  1539.  
  1540. 11.     Looping envelope
  1541.         Command: EN2
  1542.         Keyboard: Shift-E
  1543.  
  1544. This  works like command EN1, except that when the end is reached, execution
  1545. will start again from the beginning.
  1546.  
  1547.  
  1548. WAVEFORM/PITCH CONTROL SEQUENCE COMMANDS
  1549. ----------------------------------------
  1550.  
  1551. 1.      Set waveform
  1552.         Command: ---
  1553.         Keyboard: ---
  1554.  
  1555. This  command  is  used  to indicate the waveform number (starting from 00).
  1556. After  this  instruction,  the  execution  stops until the next timing pulse
  1557. occurs.    Don't use waveform numbers that are higher than the actual number
  1558. of the last waveform.
  1559.  
  1560.         Example:
  1561.         00  00  <= waveform 00
  1562.         01  01  <= waveform 01
  1563.         ...
  1564.  
  1565. 2.      End sequence
  1566.         Command: END
  1567.         Keyboard: ---
  1568.  
  1569. This  command  terminates  the  volume  control  seq.  It's always there and
  1570. automatically inserted.  You can't insert commands past this one.
  1571.  
  1572. 3.      Set pitch change down speed
  1573.         Command: CHD
  1574.         Keyboard: D
  1575.  
  1576. This command sets the sliding speed for sliding the pitch down.  The sliding
  1577. automatically  starts after this command and stops, when the speed is set to
  1578. zero.
  1579.  
  1580.         Example:
  1581.         00 CHD
  1582.         01  03  <= set speed to 3
  1583.         ...
  1584.  
  1585. 4.      Set pitch change up speed
  1586.         Command: CHU
  1587.         Keyboard: U
  1588.  
  1589. Like the previous command, but slides the pitch up.
  1590.  
  1591. 5.      Wait
  1592.         Command: WAI
  1593.         Keyboard: W
  1594.  
  1595. This command waits for a specified amount of timing pulses (pause).
  1596.  
  1597.         Example:
  1598.         03  WAI
  1599.         04   02  <= wait for 2 pulses to occur
  1600.  
  1601. 6.      Jump
  1602.         Command: JMP
  1603.         Keyboard: J
  1604.  
  1605. Causes an immediate jump to another waveform/pitch seq position.
  1606.  
  1607.         Example:
  1608.         05  JMP
  1609.         06   0A  <= jump forward to line 0A
  1610.  
  1611. 7.      Jump volume sequence
  1612.         Command: JVS
  1613.         Keyboard: Shift-J
  1614.  
  1615. This  command  causes  a jump to happen in the volume sequence.  Can be used
  1616. e.g.  for triggering volume changes after some waveform event.
  1617.  
  1618.         Example:
  1619.         09  JVS
  1620.         0A   00  <= start volume sequence from the beginning
  1621.  
  1622. 8.      Halt
  1623.         Command: HLT
  1624.         Keyboard: H
  1625.  
  1626. This  has  the  same  effect  as command END (halt execution), but it can be
  1627. inserted in the middle of the control sequence.
  1628.  
  1629.         Example:
  1630.         03  HLT
  1631.         04   04  <= some other code (can be accessed with JMP instruction,
  1632.         ...         for example)
  1633.  
  1634. 9.      Set speed
  1635.         Command: SPD
  1636.         Keyboard: S
  1637.  
  1638. Sets the execution speed.
  1639.  
  1640.         Example:
  1641.         0A  SPD
  1642.         0B   01  <= speed = 1 (fastest)
  1643.         ...
  1644.  
  1645. 10.     Begin arpeggio definition
  1646.         Command: ARP
  1647.         Keyboard: A
  1648.  
  1649. This  command  starts  the arpeggio sequence.  The subsequent values are the
  1650. arpeggio  offsets  from  the base note.  The arpeggio sequence is terminated
  1651. with  the ARE command.  The arpeggio starts automatically after the sequence
  1652. is defined.
  1653.  
  1654.         Example:
  1655.         03  ARP  <= start arpeggio
  1656.         04   00  <= offset values
  1657.         05   04
  1658.         06   07
  1659.         07   0A
  1660.         08  ARE  <= end arpeggio definition
  1661.  
  1662. 11.     End arpeggio definition
  1663.         Command: ARE
  1664.         Keyboard: E
  1665.  
  1666. Ends an arpeggio definition. See above.
  1667.  
  1668. 12.     Set vibrato depth
  1669.         Command: VBD
  1670.         Keyboard: V
  1671.  
  1672. This command is used to set the vibrato depth (00 - 7F).
  1673.  
  1674.         Example:
  1675.         02  VBD
  1676.         03   04  <= set depth to 4
  1677.  
  1678. 13.     Set vibrato speed
  1679.         Command: VBS
  1680.         Keyboard: Shift-V
  1681.  
  1682. This command sets the vibrato speed (00 - 7F).  Both speed and depth must be
  1683. non-zero for vibrato to occur.
  1684.  
  1685.         Example:
  1686.         02  VBD
  1687.         03   04  <= depth = 4
  1688.         04  VBS
  1689.         05   30  <= speed = 30
  1690.  
  1691. 14.     Reset pitch
  1692.         Command: RES
  1693.         Keyboard: R
  1694.  
  1695. This command resets the pitch of the note to its initial pitch.
  1696.  
  1697. 15.     Set vibrato waveform
  1698.         Command: VWF
  1699.         Keyboard: Shift-W
  1700.  
  1701. Sets the vibrato waveform.  The argument is the number of the waveform.  The
  1702. waveform  should  always  be 32 bytes long!!  Note that it's actually played
  1703. reversed (use the Reverse gadget to reverse it).  By default, a sine wave is
  1704. used.
  1705.  
  1706.         Example:
  1707.         00  VBD
  1708.         01   06
  1709.         02  VBS
  1710.         03   40
  1711.         04  VWF
  1712.         05   04  <= use waveform number 04 as vibrato waveform
  1713.  
  1714.  
  1715.  
  1716. The Sample Editor   [ Keyboard shortcut: Left Alt-E ]
  1717.  
  1718. This window allows you to edit and digitize samples.  It is activated either
  1719. by  using the Display menu or by clicking "Edit Sample" on the upper screen.
  1720.  
  1721. Displayed  in  the  window  is  either the current sample's waveform, or the
  1722. words "No sample loaded" if the current instrument slot is empty.
  1723.  
  1724. The  scroll  bar  below  the  waveform  shows  the  size and position of the
  1725. displayed  portion  of  the  sample  relative  to the whole sample.  It also
  1726. allows  you  to  scroll  around  the sample (after zooming in, see later) by
  1727. dragging it.  Scrolling can also be done using the cursor left / right keys.
  1728.  
  1729. Many  operations  act on a specific range, which is set by dragging the left
  1730. mouse  button  along  the  waveform.    After  selecting  the range, you may
  1731. re-adjust  the  start  or  end  positions  by holding down a Shift key while
  1732. dragging the left mouse button.
  1733.  
  1734. The gadgets above the waveform are as follows:
  1735.  
  1736. Display
  1737. This  display  box contains the number of bytes currently being displayed in
  1738. the waveform.  It changes when zooming in or out (see later).
  1739.  
  1740. Buffsize
  1741. The  size  of  the  current  sample (waveform buffer).  Typing in a new size
  1742. brings  up  a  requester,  asking  whether to clear the sample or retain the
  1743. sample already in memory.
  1744.  
  1745. One  use of retaining the sample is adding extra "workspace" to the end of a
  1746. sample,  which  is  useful  in  some editing operations (e.g.  echoing).  By
  1747. choosing  "Clear"  you  may create a new sample, and this is often the first
  1748. step when digitizing (see later).
  1749.  
  1750. There  need  not  be  a  sample in memory in order to enter a new size.  The
  1751. maximum buffer size is 131072.
  1752.  
  1753. Range Start/End
  1754. These  gadgets  show  the  actual byte positions of the start and end of the
  1755. range, and can be changed by entering a new value into them.
  1756.  
  1757. The following gadgets lie below the waveform:
  1758.  
  1759. Play Display
  1760. Plays the current display at the current pitch (see "Pitch" below).
  1761.  
  1762. Zoom In / Out
  1763. Magnifies  / reduces the sample so you can see more / less detail.  Repeated
  1764. clicking  takes  you  deeper  into  / further away from the sample.  This is
  1765. essential for accurate editing.
  1766.  
  1767. Show All
  1768. Restores the whole waveform to view after zooming.
  1769.  
  1770. Range Display
  1771. Ranges the whole display.
  1772.  
  1773. Sample</>Buffer
  1774. Copies  the  copy  buffer  to the sample, and the sample to the copy buffer.
  1775. Can  be  used to implement a simple "undo".  Before trying out a function, a
  1776. snapshot  of the sample can be made with "Sample<".  If you're not satisfied
  1777. with the outcome of the function, the sample can be restored with ">Buffer".
  1778.  
  1779. Monitor
  1780. Opens  a  window  that  displays the real-time input waveform from a sampler
  1781. (connected  to  the  parallel port).  The purpose of Monitor is to make sure
  1782. the  sound  is  at  a  volume  level  that  will not cause distortion in the
  1783. digitizing process (see below).
  1784.  
  1785. The  rest  of  the  program  is  disabled  during monitoring, i.e.  no other
  1786. functions can be selected.  Closing the window stops monitoring.
  1787.  
  1788. Digitize
  1789. Starts  digitizing  (also  called  "sampling").    The  screen   blanks, and
  1790. multitasking  is  disabled.  The sampling stops when the buffer is full, but
  1791. it can be interrupted with the right mouse button.
  1792.  
  1793. Clicking Digitize when Buffsize is zero sets Buffsize to 131072 bytes (or if
  1794. not enough memory, to the largest size possible).
  1795.  
  1796. Pitch
  1797. The  numerical  box  displays the current sampling / playing period, and the
  1798. raised  box  shows  the equivalent note to the period value.  The default is
  1799. 428  (note C-2), but this can be changed by either entering a value into the
  1800. gadget,  or holding the left mouse button on the note box and entering a new
  1801. note using the keyboard.
  1802.  
  1803. Freehand
  1804. When on, you may edit the waveform with the mouse.  The maximum display size
  1805. is  628  bytes,  but you may zoom closer if you wish.  In Freehand mode, the
  1806. Pixel display mode is automatically selected.
  1807.  
  1808. Loop
  1809. A  sample  having  a  loop  means  that  a  note you play with the sample is
  1810. sustained  until  it is stopped.  This is due to a particular section of the
  1811. sample  being continually repeated (or "looped"), and the boundaries of this
  1812. section are defined by the two "loop pointers".
  1813.  
  1814. These  pointers  appear  as  dotted  lines  over  the waveform, and as small
  1815. triangles  in  the  rectangle immediately below the waveform.  They mark the
  1816. start and end of the looped section.
  1817.  
  1818. The  "Loop"  check  box  is  a  duplicate  of  the  "Loop  On" gadget in the
  1819. Instrument Parameters window.  Selecting this gadget activates the loop.
  1820.  
  1821. Loop Point
  1822. The loop pointers can be moved in three different ways:
  1823.  
  1824. * Typing  in  the  Repeat  and/or RepLen value in the Instrument Parameters
  1825.   window
  1826.  
  1827. * Dragging the small triangles across the waveform
  1828.  
  1829. * Using the Loop Point gadgets
  1830.  
  1831. The < and > gadgets move a loop pointer two bytes to the left or right.
  1832.  
  1833. <0  and  0>  move a loop pointer to the left or right until a zero is found.
  1834. For  a  decent-sounding  loop, it ideally needs to start and end at the same
  1835. value,  which  can often be zero (i.e.  no amplitude).  So these gadgets are
  1836. useful in finding good loop points.
  1837.  
  1838. The cycle gadget selects whether the < > <0 0> gadgets act on the loop start
  1839. (default) or loop end pointer.
  1840.  
  1841. Bear in mind that zooming in allows far more accurate loop positioning.
  1842.  
  1843. The following gadgets act on the currently selected range (see above):
  1844.  
  1845. Show
  1846. Magnifies the range to fill the whole display.
  1847.  
  1848. Play
  1849. Plays the range at the current pitch.
  1850.  
  1851. Cut
  1852. Deletes the range and moves it to the copy buffer.
  1853.  
  1854. Erase
  1855. Deletes  the  range  (but  doesn't  move it to the copy buffer).  NOTE TO V4
  1856. UPGRADERS: this is like V4's DEL button.
  1857.  
  1858. Clear
  1859. Clears the range.
  1860.  
  1861. Copy
  1862. Copies the range to the copy buffer.
  1863.  
  1864. Paste
  1865. Inserts  the  copy  buffer's contents at the start of the range.  The sample
  1866. size will increase by the number of bytes inserted.
  1867.  
  1868. Reverse
  1869. Reverses  the  range left to right.  Useful for interpreting hidden messages
  1870. in a few rock songs ;)
  1871.  
  1872. The menus attached to this window are as follows:
  1873.  
  1874. Project
  1875. -------
  1876.  
  1877. Flush Sample
  1878. Removes the current instrument from memory.
  1879.  
  1880. Load Sample
  1881. Opens a file requester to load a sample.
  1882.  
  1883. Save Sample As
  1884. Opens a file requester to save an IFF sample.  Note that the loop values are
  1885. also saved with IFF samples.
  1886.  
  1887. Exit Sample
  1888. Closes the sample editor window.  Editor
  1889.  
  1890. Edit
  1891. ----
  1892.  
  1893. With this menu you may edit the sample.
  1894.  
  1895. The  Cut,  Copy,  Paste,  Erase,  Clear  and  Reverse  items have equivalent
  1896. functions to the respective Range gadgets.
  1897.  
  1898. Invert
  1899. Inverts the range (turns it upside-down).  This can be useful when trying to
  1900. find  a  smooth  loop  or a smooth join between two waveforms (freehand mode
  1901. also helps this).
  1902.  
  1903. Chop
  1904. Deletes  the  non-ranged  parts of the sample.  Only the part defined by the
  1905. range is left.
  1906.  
  1907. Remove Unused Space
  1908. Deletes  empty space (i.e.  of zero volume) on either side of the waveform. 
  1909. This both saves memory and keeps the timing in songs precise.
  1910.  
  1911. Copy to Synth Editor
  1912. Transfers the current range to the synthetic sound editor, thus allowing you
  1913. to  create  a  less  memory-consuming instrument.  The synth editor can only
  1914. handle  waveforms of 128 bytes maximum, so if the range is longer than that,
  1915. only  the  first  128  bytes  marked are copied.  The range is copied to the
  1916. right-hand  waveform  display.   If you want the new synthetic instrument to
  1917. replace  the  sample  in  memory,  you  need  to make the current instrument
  1918. synthetic.
  1919.  
  1920. Play Buffer Contents
  1921. Plays the contents of the copy buffer at the current pitch.
  1922.  
  1923. Discard Copy Buffer
  1924. Discards and frees the memory occupied by the copy buffer.
  1925.  
  1926. Effects
  1927. -------
  1928.  
  1929. This menu adds special effects to the sample.
  1930.  
  1931. Change Volume   
  1932. Brings up the Change Volume window.
  1933.  
  1934. Change Pitch
  1935. Brings up the Change Pitch window.
  1936.  
  1937. Mix
  1938. Brings up the Mix window.
  1939.  
  1940. Filter/Boost
  1941. Brings up the Filter/Boost window.
  1942.  
  1943. Echo
  1944. Brings up the Echo window.
  1945.  
  1946. Create Noise
  1947. Brings up the Noise window.
  1948.  
  1949. Create Chord
  1950. Brings up the Chord Creation window.
  1951.  
  1952. Note  that  all effects aside from Change Pitch, Mix and Create Chord affect
  1953. the  current  RANGE.    So  if  you wish these effects to apply to the whole
  1954. sample, use the Range Display gadget.
  1955.  
  1956. Also,  shift-clicking any of the action buttons (i.e.  those which perform a
  1957. function) in these windows executes the function then closes the window.
  1958.  
  1959. Settings
  1960. --------
  1961. Display
  1962. "Line"  selects the normal line display mode, but when "Pixel" is turned on,
  1963. the  sample  is  displayed  as  pixels  instead  of  lines.  "Pixel Density"
  1964. activates  the Pixel Density window with which you can choose the density of
  1965. the pixels in "Pixel" mode.
  1966.  
  1967. Sampler Voice Monitor
  1968. When  selected,  you  can hear the sound you are sampling during digitizing.
  1969. Turning  this  off  may  marginally enhance the digitizing quality on slower
  1970. machines (those using a 68000 processor).  @ENDNODE
  1971.  
  1972.  
  1973. The Change Volume Window   [ Keyboard shortcut: Amiga-O ]
  1974.  
  1975. This  window  allows  you  to change the volume of the current range, and is
  1976. opened using the sample editor's Effects menu.
  1977.  
  1978. The  sliders  select  the  starting  and  ending volume change, and both are
  1979. percentages of the original waveform.  For example, setting the start volume
  1980. to  150  %  and  the  end volume to 75 % fades downwards from one-and-a-half
  1981. times  the  original  volume to three-quarters of the original volume.  Each
  1982. slider can select a value of 0 - 500 %.
  1983.  
  1984. Clicking CHANGE VOLUME changes the volume using the current slider values.
  1985.  
  1986. There  are  also  some commonly-used presets below the CHANGE VOLUME gadget.
  1987. "Fade  In"  changes from 0 % to 100 %, "Fade Out" from 100 % to 0 %, "Halve"
  1988. 50 % - 50 %, and "Double" 200 % - 200 %.  Clicking any of these gadgets sets
  1989. the sliders to the values they represent, then changes the volume.
  1990.  
  1991. Fade  In  /  Out  are  useful  partly  in  eliminating  the "click" that you
  1992. sometimes  hear  at the very start and end of a sample.  To do this, range a
  1993. small piece of waveform at the start or end of the sample, and click Fade In
  1994. for the start or Fade Out for the end.
  1995.  
  1996. Normally,  if  the  volume is increased too much, the normal waveform limits
  1997. are exceeded and distortion (or "clipping") will occur.  If the "Don't Clip"
  1998. gadget is switched on, however, the waveform limits will not be exceeded.
  1999.  
  2000. The "Exit" gadget closes the window.
  2001.  
  2002.  
  2003. The Change Pitch Window   [ Keyboard shortcut: Amiga-P ]
  2004.  
  2005. This  window  lets  you  change  the pitch of (or "retune") the sample.  The
  2006. sample's  size  will  also  change:  it  will  decrease if the pitch is made
  2007. higher,  and  increase  if  the  pitch is lowered.  (The window is opened by
  2008. using the sample editor's Effects menu).
  2009.  
  2010. For example, if you'd like to retune the current sample to play the note G-2
  2011. when you press the C-2 key:
  2012.  
  2013. 1.    Set  the  source  note  to C-2 by holding the left mouse button on the
  2014. "Source" note box and pressing the C-2 key;
  2015.  
  2016. 2. Set the destination note to G-2 in the same way;
  2017.  
  2018. 3.   Click "Change Pitch".  The sample is retuned, and its size in this case
  2019. will decrease by roughly two-thirds.
  2020.  
  2021. Other gadgets are:
  2022.  
  2023. Octave Up/Down
  2024. Retunes  the  sample  one  octave up / down, halving / doubling the sample's
  2025. size.    The  "Period"  gadgets  are  changed  to  the  values the operation
  2026. represents.
  2027.  
  2028. Cancel Finetune
  2029. Retunes  the  sample so that the Finetune value in the Instrument Parameters
  2030. window no longer applies.  So if the finetune value was -4, the sample would
  2031. be  retuned 4 steps down and the instrument's finetune would be set to zero.
  2032.  
  2033. Anti-Alias
  2034. When  on,  does  some anti-aliasing when retuning.  This means that noise is
  2035. reduced, and is the default.
  2036.  
  2037. Exit
  2038. Closes the window.
  2039.  
  2040.  
  2041. The Mix Window   [ Keyboard shortcut: Amiga-M ]
  2042.  
  2043. This  window  contains  the  gadgets required to combine two samples, and is
  2044. activated using the Effects menu in the sample editor.  The sample placed in
  2045. the copy buffer (using the >Buffer gadget in the sample editor will be mixed
  2046. with the current sample.
  2047.  
  2048. The  two  sliders  control the volumes of the two waveforms to be mixed.  To
  2049. understand  them  fully, you need to bear in mind that mixing is achieved by
  2050. ADDING the two samples together.  So if the samples were both mixed at 100 %
  2051. volume, the resulting mixed sample would be 200 % (double) in volume.
  2052.  
  2053. For this reason, the default for each sample is 50 %, giving a 100 % (normal
  2054. volume) mixed sample.  Each slider's value may be 0 - 100 %.
  2055.  
  2056. (For  those  that  are interested, this is why samples should be "halved" in
  2057. 5-8-channel  mode:  the  samples  are  added  at half their normal volume to
  2058. produce a full volume sample).
  2059.  
  2060. The  volume  of  the  sample in the copy buffer is altered using the "Dest. 
  2061. Level"  slider,  and  that  of  the  current sample using the "Source Level"
  2062. slider.
  2063.  
  2064. The sample in the copy buffer is mixed at the point marked by a range in the
  2065. current sample.  If the range is more than one byte in length, only the area
  2066. selected  by  the  range  is  affected;  otherwise,  the whole of the sample
  2067. starting at Range Start is affected.
  2068.  
  2069. The "Mix" gadget mixes the sample, and "Exit" closes the window.
  2070.  
  2071.  
  2072. The Filter/Boost Window   [ Keyboard shortcut: Amiga-F ]
  2073.  
  2074. This window includes a function to filter the current range, reducing noise,
  2075. and  to boost the current range, making it sound brighter and more audible. 
  2076. The window is brought up using the sample editor's Effects menu.
  2077.  
  2078. Filtering is done by calculating the average of each individual value in the
  2079. sample  and  the  values on either side of it.  Boosting employs an opposite
  2080. process.
  2081.  
  2082. There are two sliders, both of which can have a value of 1 - 128:
  2083.  
  2084. Averaging
  2085. The  strength  of  the filter/boost (technical note: the proportions of each
  2086. individual  value  compared to the values on either side of it).  The higher
  2087. the value, the greater the strength.  The default is 16.
  2088.  
  2089. Distance
  2090. The  distance  between the averaged values.  In practical terms, this slider
  2091. affects  the  sound  in an odd way!  (It's best to experiment with different
  2092. values).  For a normal filter/boost, set this to 1 (the default).
  2093.  
  2094. The Filter gadget filters, Boost gadget boosts, and Exit closes the window.
  2095.  
  2096.  
  2097. The Echo Window   [ Keyboard shortcut: Amiga-K ]
  2098.  
  2099. With  this window, interesting echo effects can be produced.  It is revealed
  2100. using  the  sample  editor's  Effects  menu.   The echo function affects the
  2101. current range.
  2102.  
  2103. Before  echoing,  you usually need to add some extra space to the end of the
  2104. sample,  by  typing  a  new  value into Buffsize (in the sample editor) then
  2105. choosing  "Retain" in the requester.  You need to range both the waveform to
  2106. be echoed and the blank space that the echo is to affect.
  2107.  
  2108. There are three integer gadgets:
  2109.  
  2110. Echo Rate
  2111. The  distance,  in  bytes,  between  two echoes.  A very low rate can make a
  2112. speech sample sound like a robot :-D
  2113.  
  2114. Volume Decrease
  2115. Specifies the rate of volume decrease in the echo.  The lower the value, the
  2116. lower the rate, but a value of zero spreads the volume evenly throughout the
  2117. range.
  2118.  
  2119. Number of Echoes
  2120. The total number of echoes produced, usually quite low (1 - 10).
  2121.  
  2122. The best way to learn this feature is through experimentation.
  2123.  
  2124. The "Do Echo" gadget executes the function, and "Exit" closes the window.
  2125.  
  2126.  
  2127. The Noise Window   [ Keyboard shortcut: Amiga-N ]
  2128.  
  2129. This window is opened using the sample editor's Effects menu.
  2130.  
  2131. The  fairly  unique  feature  in  the  window allows you to add noise to the
  2132. current  range.    It  may seem useless at first glance, but with it you can
  2133. easily create effects such as wind and sea sounds, and it can be a source of
  2134. more  complex  instruments  when  used together with other effects.  So it's
  2135. possible to create good-sounding instruments even without using a sampler!
  2136.  
  2137. The  slider sets the noise strength (1 - 128), which is really the volume of
  2138. the produced noise.  The "Noise" gadget creates noise, and "Exit" closes the
  2139. window.
  2140.  
  2141.  
  2142. The Chord Creation Window     [ Keyboard shortcut: Amiga-H ]
  2143.  
  2144. With this window you can create chords of two to four notes from the current
  2145. sample.  The window is brought up using the sample editor's Effects menu.
  2146.  
  2147. The  window consists of four pitch gadgets, whose contents can be changed by
  2148. holding down the left mouse button and pressing a note on the keyboard.  You
  2149. may also clear the note by pressing Return or Del.
  2150.  
  2151. The  basenote  is  the  note  to which the chord notes relate.  In practical
  2152. terms  you  can  think  of it as the "bass note".  The other gadgets are the
  2153. other notes in the chord, of which some may be blank if desired.
  2154.  
  2155. Note  that  you  are  not  restricted  to the normal three-octave range of a
  2156. sample: you may use pitches over the full 10.5-octave range.  Also note that
  2157. higher  notes  are  shorter  in length than lower notes, so the notes in the
  2158. chord will not end simultaneously.
  2159.  
  2160. "Create Chord" creates the chord and stores it in the current sample.
  2161.  
  2162. "Exit" closes the window.
  2163.  
  2164.  
  2165. The Pixel Density Window     [ Keyboard shortcut: Amiga-D ]
  2166.  
  2167. The  slider in this window sets the density of the pixels (1 - 50) used when
  2168. drawing  the  waveform  in  "Pixel"  mode  (see the Sample Editor}, Settings
  2169. menu).
  2170.  
  2171. The  slider  value  is  in  reality  the number of pixels displayed in every
  2172. horizontal pixel position.
  2173.  
  2174. The "Exit" gadget closes the window.
  2175.  
  2176.  
  2177. The Sample List Editor   [ Keyboard shortcut: Amiga-L ]
  2178.  
  2179. As  you  work  with  computer  music  you  will  acquire  large   numbers of
  2180. instruments,  spread  over  many  different disks and directories.  For easy
  2181. loading,  the  samples  need  to  be  organized.    This window provides the
  2182. necessary  functions for organizing and storing a list of all your samples. 
  2183. (It is opened using the Display menu.
  2184.  
  2185. The  list  could  be  created  using any text editor (as it had to be in the
  2186. early  days  of  MED),  but it's now much easier to make one with the Sample
  2187. List Editor.
  2188.  
  2189. Basically,  a  list  is  created  by  clicking  "Add  Dir..." and choosing a
  2190. directory containing samples from the file requester.  The directory and its
  2191. filenames  are then added to the list, and this can be repeated for all your
  2192. sample  directories  /  disks.    You  may  view  a directory's filenames by
  2193. clicking the required directory name in the "Directories" list.
  2194.  
  2195. The list is saved using "Save List...", and the filename is "MED_paths".  On
  2196. startup,  OctaMED  looks for the MED_paths file in the current directory and
  2197. in  the S: directory (and loads it if it's found).  The default save path is
  2198. S:.
  2199.  
  2200.  
  2201. The gadgets in this window are as follows:
  2202.  
  2203. Add
  2204. Adds  the  current  instrument to the filenames list (it will be inserted in
  2205. alphabetical  order).    Note  that  the  sample's  loop,  tuning, MIDI, and
  2206. relative volume values will also be stored, as well as its default pitch.
  2207.  
  2208. Remove
  2209. Removes  the  instrument  selected  in  the  sample  list  (i.e.  click on a
  2210. filename and press "Remove").
  2211.  
  2212. Save Ins
  2213. Saves  the current instrument to the currently selected directory (stores it
  2214. on disk as well as in the list).
  2215.  
  2216. Del Ins
  2217. Like  "Remove",  but  also deletes the instrument from disk.  These last two
  2218. options  remove  the  need  to  use  a  file  requester  to  save  or delete
  2219. instruments in the sample list.
  2220.  
  2221. Add Dir
  2222. Opens  a  file  requester  to add a directory to the list.  A requester will
  2223. also  appear,  inquiring  whether  you  wish  to add the directory after the
  2224. currently selected directory or to the end of the list.
  2225.  
  2226. Remove Dir
  2227. Removes the current directory from the list.
  2228.  
  2229. Save List
  2230. Opens  a  file  requester  to  save  the list to disk.  Note that on startup
  2231. OctaMED  looks  for  the  MED_paths file in the current directory and the S:
  2232. directory,  so  be sure to either save it in the S: directory or in the same
  2233. directory  as  the  OctaMED  program.    It is usually best to choose the S:
  2234. directory,  as  then  it  doesn't  matter what the current directory is when
  2235. starting OctaMED.
  2236.  
  2237. Load Inst
  2238. Loads  the  selected sample list instrument to the current sample slot.  (An
  2239. easier method of loading instruments in the sample list is found in the Load
  2240. Instrument Window.
  2241.  
  2242. Save All Insts
  2243. Saves  all  instruments  in  the song to the current directory.  This can be
  2244. handy  for  extracting  (or  "ripping")  all the samples from other people's
  2245. songs, for use in your own songs.
  2246.  
  2247. The  Name text gadget displays the name of the selected instrument.  You may
  2248. rename the instrument by typing a new name into this gadget.
  2249.  
  2250. The  remaining integer gadgets are the current loop / tuning / MIDI / volume
  2251. values  of  the  selected  instrument,  and  the Pitch gadget is the current
  2252. default  pitch  of the selected instrument (if any).  They can be changed by
  2253. entering  a  new  value,  or  by  holding the left mouse button on the Pitch
  2254. gadget and pressing a new note on the keyboard.  Note that the MIDI and loop
  2255. (Repeat  /  RepLen)  gadgets can't both be used at the same time: changing a
  2256. MIDI gadget value sets the loop gadgets to zero, and vice-versa.
  2257.  
  2258. (For a description of loop / tuning / MIDI / relative volume values, and the
  2259. default instrument pitch, see the Instrument Parameters Window.
  2260.  
  2261. Since  MIDI instruments are not actually instruments but a few settings, you
  2262. may wish to create a "dummy" directory for MIDI instruments.
  2263.  
  2264. The Exit gadget closes the window.
  2265.  
  2266.  
  2267. The menu contains the following items:
  2268. --------------------------------------
  2269.  
  2270. Load List
  2271. Opens  a  file requester to load a sample list.  The new list is appended to
  2272. the list already in memory.
  2273.  
  2274. Stats
  2275. Displays statistics about the sample list:
  2276.  
  2277. * The currently selected directory number
  2278. * The total number of directories in the list
  2279. * The number of samples in the current directory
  2280. * The total number of samples in the list
  2281.  
  2282.  
  2283. The MIDI Message Editor   [ Keyboard shortcut: Amiga-G ]
  2284.  
  2285. This window offers the tools required to capture, send, and store MIDI data,
  2286. and  to edit MIDI messages in hexadecimal.  (Opening this window is achieved
  2287. using the Display menu.
  2288.  
  2289. The message editor is especially suitable for, but not limited to, capturing
  2290. System  Exclusive (SysEx) messages.  These are very versatile messages which
  2291. can  (for  example)  be  used  to  set and alter the parameters of sounds on
  2292. machines  supporting  this  facility.    You  can   edit   sounds using your
  2293. synthesizer,  then  transfer  either  the original sound or the edited sound
  2294. into  your Amiga® and save it.  Later on, OctaMED can send the sound back to
  2295. the synthesizer for playing.
  2296.  
  2297. The  gadgets  to  the  right  of "Msg" are: current message number, previous
  2298. message, next message, and total number of messages in the buffer.
  2299.  
  2300. Other gadgets include:
  2301.  
  2302. New Msg
  2303. Adds  a new message to the end of the list.  Use this gadget to create a new
  2304. message after booting OctaMED.
  2305.  
  2306. New Here
  2307. Inserts  a  new message at the current point in the list.  Usually "New Msg"
  2308. is preferred to this gadget.
  2309.  
  2310. Del Msg
  2311. Deletes the current message.
  2312.  
  2313. Clear Msg
  2314. Clears the current message (sets all bytes to zero).
  2315.  
  2316. Msg Size
  2317. Newly  created  messages  are eight bytes long, but to capture (for example)
  2318. SysEx  messages,  a  much  larger buffer is required.  So use this gadget to
  2319. change  the message size.  The arrow gadgets decrease / increase the size by
  2320. one.  The maximum size is 1048560 bytes.
  2321.  
  2322. Name
  2323. Allows  you  to  name  the message: it's usually hard to recognize a message
  2324. just by looking at it!  :)
  2325.  
  2326. Save Msg
  2327. Opens a file requester to save the current message.  Note that MIDI messages
  2328. are  automatically  saved  with  modules  (except  Tracker modules, see Save
  2329. Options,  but  you may wish to save them as separate files you can load into
  2330. other songs.
  2331.  
  2332. Load Msg
  2333. Opens a file requester for loading a message.  A requester appears wondering
  2334. whether  the  new  message  should  replace  the current one or create a new
  2335. message for itself.
  2336.  
  2337. Capture Msg
  2338. To  capture  data from your MIDI device, set up an empty message as large as
  2339. or  larger  than  the  incoming  data, click this gadget, then start sending
  2340. data.  Clicking it again stops capturing (although with SysEx messages there
  2341. is an easier way to stop capturing, see "Auto-Terminate Capture" below).
  2342.  
  2343. MIDI  Active  and  Input  Active in the MIDI menu are automatically selected
  2344. when Capture Msg is pressed.
  2345.  
  2346. Send Msg
  2347. Sends  out  the current MIDI message.  Player command 10 also does this (see
  2348. MIDI Commands).
  2349.  
  2350. Auto-Terminate Capture
  2351. Causes  OctaMED to stop capturing when an End SysEx byte ($F7) is received. 
  2352. OctaMED  will  also  remove  all  unused bytes at the end of the buffer: you
  2353. shouldn't  leave  any unused (zero) bytes after the actual MIDI data.  These
  2354. zeros  are  MIDI  data  too, which will be sent, and this is likely to cause
  2355. problems.  So this gadget is usually kept switched on.
  2356.  
  2357. If  this  gadget  is  off,  however, OctaMED will capture all incoming bytes
  2358. until either the "Capture Msg" gadget is re-clicked or the end of the buffer
  2359. is reached.
  2360.  
  2361. The  display box to the right of Auto-Terminate Capture shows "Recording..."
  2362. when a MIDI message is being captured.
  2363.  
  2364. Exit
  2365. Closes the window.
  2366.  
  2367. You  may  also edit the hex data.  Make sure Edit is on (upper screen), then
  2368. simply  use  the  cursor  keys  to move around the data and the numeric keys
  2369. (0-9,  A-F)  to  modify the hex data.  Use the Del key to delete a byte, and
  2370. Shift-Del to insert a new one.
  2371.  
  2372.  
  2373. (See also MIDI Commands, the MIDI Menu, and the Input Map Editor)
  2374.  
  2375.  
  2376. The Input Map Editor   [ Keyboard shortcut: Amiga-A ]
  2377.  
  2378. With  this  window you may remap all the input keys on your keyboard.  It is
  2379. opened using the Display menu.
  2380.  
  2381. Each key can be assigned to:
  2382.  
  2383. --  enter any note/command you wish (similar to Programmable Keys)
  2384.  
  2385. --  perform an action (such as moving the cursor up or down)
  2386.  
  2387. This  also  works  with  a  standard Amiga® keyboard: a MIDI keyboard is not
  2388. required.
  2389.  
  2390. The  two  columns  of  numbers  in the list are the entry numbers in hex and
  2391. decimal.
  2392.  
  2393. The other gadgets included in this window are:
  2394.  
  2395. Map Active
  2396. When  this  is selected, the current input map will be used in preference to
  2397. the default OctaMED keyboard map.
  2398.  
  2399. Create New Map
  2400. By  default  there  is no input map, so this must be clicked to create a new
  2401. one.
  2402.  
  2403. Now, for each note an entry like this is displayed: "C-1xxxxxx", which means
  2404. that the C-1 key will just enter C-1 with the current instrument number, and
  2405. leave the command numbers untouched.
  2406.  
  2407. You  may  edit  an entry in the same way as in the Programmable Keys window.
  2408. Select  an entry by clicking on it, hold down the mouse button, point at the
  2409. number you wish to change and press a key on the keyboard to change it.
  2410.  
  2411. Delete This Map
  2412. After a confirmation requester, removes the current map.
  2413.  
  2414. Select Function
  2415. Displays the Functions window, with which you may select an editing function
  2416. for the currently selected key.
  2417.  
  2418. Reset Selected
  2419. Changes the selected key back to its original function.
  2420.  
  2421. Load Map
  2422. Displays  a file requester, allowing you to load a new input map from disk. 
  2423. A requester will appear if the current input map has been changed since last
  2424. saving.
  2425.  
  2426. Save Map
  2427. Opens  a  file  requester,  offering to save the current input map to disk. 
  2428.  
  2429.  
  2430. The Functions Window
  2431.  
  2432. This  window displays a list of editing functions for use with the input map
  2433. editor.  It is opened by clicking "Select Function" in the editor.
  2434.  
  2435. Clicking  one of the functions in the window changes the selected key in the
  2436. input map editor to that function.
  2437.  
  2438. All functions should be self-explanatory.
  2439.  
  2440.  
  2441. The Song Selector Window     [ Keyboard shortcut: Left Alt-G ]
  2442.  
  2443. This  window  allows  you  to add and delete songs in a multi-module, and to
  2444. choose  the current song.  (A "multi-module" is a project that contains more
  2445. than  one song, with all songs sharing the same set of instruments).  It may
  2446. be brought up by choosing Song menu/Select, or by clicking "Sg" on the upper
  2447. screen.
  2448.  
  2449. The  window  displays  a  list of all songs in the module, and a song may be
  2450. selected  by  clicking  on  it.   The song's name appears in the display box
  2451. immediately below the list.
  2452.  
  2453. The gadgets in this window are as follows:
  2454.  
  2455. Add New
  2456. Adds a new song to the end of the list.
  2457.  
  2458. Add Here
  2459. Adds a new song at the currently selected position.
  2460.  
  2461. Delete
  2462. Deletes the selected song.
  2463.  
  2464. Select
  2465. Makes the selected song the current song, and closes the window.
  2466.  
  2467. Exit
  2468. Closes the window.
  2469.  
  2470. (Song selection gadgets are also contained on the upper screen)
  2471.  
  2472.  
  2473. The Playing Sequence Window   [ Keyboard shortcut: Left Alt-Q ]
  2474.  
  2475. The  playing sequence consists of a list of block numbers and names arranged
  2476. in the order they should be played in the song.  With the release of OctaMED
  2477. V5.0, more than one playing sequence may be defined (called "sections"), and
  2478. the  section list contains the order in which to play these multiple playing
  2479. sequences.   When the last section has been played, the song will by default
  2480. start  again  from  the  beginning  (although it's also possible to stop the
  2481. playing).
  2482.  
  2483. This window contains the functions required to create playing sequences, and
  2484. is  activated  by either clicking "Sq" on the upper screen or using the Song
  2485. menu.    A  sequence  may  use  the  same block number more than once, and a
  2486. maximum  of  999  entries  in  each  playing sequence is allowed.  ("Playing
  2487. sequence" will be referred to as "playseq" from now on).  The maximum number
  2488. of separate playseqs allowed is 65535 (should be enough!).
  2489.  
  2490. The current playseq position ("playpos") is highlighted in white, and may be
  2491. set  by  clicking  on  a  block  name.   Selecting playpos while the song is
  2492. playing immediately plays from the beginning of the entry selected.
  2493.  
  2494.  
  2495. The following gadgets for editing playseqs are included in this window:
  2496.  
  2497. Top
  2498. Sets playpos to the top of the display.
  2499.  
  2500.      [ Keyboard shortcut: Ctrl-NM7  ("NM" = numeric keypad, apologies
  2501.                                  (Home)    to Amiga® 600 owners!) ]
  2502.  
  2503. Bottom
  2504. Sets playpos to the bottom of the display.
  2505.  
  2506.      [ Keyboard shortcut: Ctrl-NM1 (End) ]
  2507.  
  2508. Insert
  2509. Duplicates the entry highlighted by playpos.
  2510.  
  2511.      [ Keyboard shortcut: Ctrl-NM0 (Ins) ]
  2512.  
  2513. Ins Curr
  2514. Inserts a new entry, the current block, at playpos.
  2515.  
  2516.      [ Keyboard shortcut: Ctrl-NM5 ]
  2517.  
  2518. Note  that  to append a playseq entry to the end of the list, you must click
  2519. just below the final playseq entry before using one of the insert gadgets.
  2520.  
  2521. Delete
  2522. Deletes the current entry.
  2523.  
  2524.      [ Keyboard shortcut: Ctrl-NM. ]
  2525.  
  2526. Clear
  2527. After a confirmation requester, clears the current playseq.
  2528.  
  2529. [  Other  keyboard  shortcuts:  Ctrl-NM8 scrolls up, Ctrl-NM2 scrolls down. 
  2530. Note  that with the Caps Lock on, the playing sequence can be edited without
  2531. holding down the Ctrl key.  ]
  2532.  
  2533. Follow
  2534. Using  the  scroll bar, it is possible to scroll around the list independent
  2535. of  playpos.    When  "Follow" is selected, the position of the list will be
  2536. automatically updated during play.
  2537.  
  2538. The  integer  gadget  to  the  left of "Follow" contains the block number of
  2539. playpos,  which  can be altered either by typing in a new number or by using
  2540. the arrow gadgets.  You can't increase the block number beyond the number of
  2541. the  last  block  in  the song.  [ Keyboard shortcuts for the arrow gadgets:
  2542. Ctrl-NM4 decreases block number, Ctrl-NM6 increases ]
  2543.  
  2544. The  arrow  gadgets  act slightly differently when playpos is below the last
  2545. playseq  entry.    Pressing  the  left  arrow gadget deletes the last entry;
  2546. pressing the right one appends block 000 to the end of the sequence.
  2547.  
  2548. The  display  box  to the right of the integer gadget contains the number of
  2549. playpos and the total number of entries in the current section.
  2550.  
  2551. Multiple playseqs (sections) can be created using the following buttons:
  2552.  
  2553. Name
  2554. Displays the name of the current section, which you can edit.
  2555.  
  2556. New Sec
  2557. Adds a new section after the last section.
  2558.  
  2559. New Sec Here
  2560. Inserts a new section at the current position.
  2561.  
  2562. Delete Sec
  2563. Deletes the current section.
  2564.  
  2565. Below these buttons is an integer gadget showing the current section number.
  2566. It  may  be  changed  by  either  typing  in a new number or using the arrow
  2567. gadgets.    The  display box to the right of the integer gadget contains the
  2568. total number of sections.
  2569.  
  2570. The Exit gadget closes the window.
  2571.  
  2572. (Note  that the song can be stopped at any time by using player command FFE:
  2573. see Commands A - F).
  2574.  
  2575. (See also the Section List and the Block List)
  2576.  
  2577.  
  2578. The Section List Window     [ Keyboard shortcut: Left Alt-C ]
  2579.  
  2580. This window, opened either by using the Song menu or by clicking "Sc" on the
  2581. upper  screen,  contains  the  order  in which to play song sections.  These
  2582. sections are created in the Playing Sequence window.
  2583.  
  2584. The  current section position ("secpos") is highlighted in white, and may be
  2585. set by clicking on a section name.  Shift-clicking on a section name selects
  2586. the  section  clicked  in  the  Playing Sequence window.  A maximum of 65535
  2587. entries  are  allowed  (note,  however, that only the lower three digits are
  2588. displayed).
  2589.  
  2590. The  integer  gadget  contains  the  section  number of secpos, which can be
  2591. altered either by typing in a new number or by using the arrow gadgets.  You
  2592. can't  increase  the section number beyond the number of the last section in
  2593. the song.
  2594.  
  2595. The  display boxes to the right of the integer gadget contains the number of
  2596. secpos  and the total number of entries in the current section list, and the
  2597. total number of sections in the song.
  2598.  
  2599. Other gadgets are as follows:
  2600.  
  2601. Insert
  2602. Inserts a new entry 001 at secpos.
  2603.  
  2604. Append
  2605. Appends a new entry 001 to the end of the section list.
  2606.  
  2607. Delete
  2608. Deletes the current entry.
  2609.  
  2610. Exit
  2611. Closes the window.
  2612.  
  2613.  
  2614. The Song Options Window   [ Keyboard shortcut: Amiga-H ]
  2615.  
  2616. This  window  contains  various  song  parameters.  In a multi-module, these
  2617. parameters  can  be  different  for each song.  (It is opened using the Song
  2618. menu.
  2619.  
  2620. The gadgets are listed below:
  2621.  
  2622. Name
  2623. This  text  gadget  contains  the name of the current song, displayed on the
  2624. title bar.  You may type in a new name.
  2625.  
  2626. Channel Mode
  2627. The  Amiga®  has  four  sound channels, but by mixing two notes together and
  2628. playing  them through one channel, up to eight notes can be played at once. 
  2629. This  radio  button  is used to select the number of channels OctaMED should
  2630. use.  (See 5-8 Channel Mode for more info).
  2631.  
  2632. Note:  for  MIDI use, "4 Channels/MIDI" should be selected (this is also the
  2633. default).
  2634.  
  2635. The  cycle gadget chooses whether the data bytes of volume (C) commands (see
  2636. Commands  A  -  F)  should  be  in  hexadecimal or decimal.  If you aren't a
  2637. programmer  (and  even  if  you are), it may be easier to think in decimal. 
  2638. "Decimal Volumes" is the default, but we recommend using hexadecimal volumes
  2639. wherever  possible.    They're  slightly  faster (not noticeably, but faster
  2640. anyway ;^).  The state of this gadget is saved as part of a song.
  2641.  
  2642. You  can  easily  convert  all volume commands from decimal to hex and vice-
  2643. versa  with  the "Convert" gadget.  Clicking this gadget prompts you for the
  2644. type of conversion desired.
  2645.  
  2646. Audio Filter Active
  2647. Turns  the  low-pass  audio  filter on/off.  When on, the Amiga®'s power LED
  2648. will  be bright.  However it is best to keep the filter off, since the sound
  2649. quality is usually better.
  2650.  
  2651. High Quality Mode
  2652. When  on,  this  significantly  increases  the  audio quality in 5-8 channel
  2653. modes.    Unfortunately,  it will also double the processor load, so a 68020
  2654. processor  or  higher  is  required  to  use  this  gadget  in   seven   and
  2655. eight-channel modes.
  2656.  
  2657. Under  OctaMED  Pro  V3  and  V4,  High Quality Mode slowed down the tempo a
  2658. fraction.  In V5 the tempo is now unaffected.  So when loading songs created
  2659. with V3 or V4 that use this mode, you'll need to slightly decrease the tempo
  2660. for the song to play at the intended speed.
  2661.  
  2662. No Slide On 1st Pulse
  2663. Normally  effects  are  done  on  every  timing pulse, but with this on, the
  2664. effects  are  not  done  on  the  first  timing  pulse.  This is the way the
  2665. Trackers  perform  effects, and this switch is for compatibility only: it is
  2666. automatically switched on when a Tracker module is loaded.  (For information
  2667. on timing pulses, see Upper Screen.
  2668.  
  2669. Play Transpose
  2670. This  slider  transposes  the  whole song by the value selected.  It doesn't
  2671. change  the  notes, it just affects playing.  The minimum and maximum is -12
  2672. and  12  respectively (i.e.  ± 1 octave).  Other transposition functions may
  2673. be found in the Transpose window.
  2674.  
  2675. Exit
  2676. Closes the window.
  2677.  
  2678.  
  2679. The Relative Track Volumes Window   [ Keyboard shortcut: Amiga-R ]
  2680.  
  2681. This  window contains sliders to adjust the volume of each track relative to
  2682. the master volume.  It is opened using the Song menu.
  2683.  
  2684. Each volume can be 1 - 64.  The master volume sets the overall volume of the
  2685. song.    If  both  the master volume and the volume of a track were 64, that
  2686. track  is played at full volume.  If, however, the master volume and a track
  2687. volume  were 32, the volume of that track would be a quarter of full volume.
  2688.  
  2689.  The  two  large arrow gadgets at the bottom left of the window are like the
  2690. track  arrow  gadgets  on  the  upper  screen  -  clicking   them   show the
  2691. previous/next  sixteen  tracks,  and shift-clicking them show the first/last
  2692. sixteen  tracks  in  the song.  (They only really apply to blocks containing
  2693. over sixteen tracks).
  2694.  
  2695. The Exit gadget closes the window.
  2696.  
  2697. Note: the status of these sliders are saved with songs.
  2698.  
  2699.  
  2700. The Block Properties Window   [ Keyboard shortcut: Amiga-B ]
  2701.  
  2702. This  window  allows you to edit the properties of the current block.  It is
  2703. activated  either  by  using  the  Block  menu  or by holding down Shift and
  2704. clicking the B gadget on the upper screen.
  2705.  
  2706. The gadgets are:
  2707.  
  2708. Name
  2709. Contains  the  name  of  the  block, which can be changed by typing in a new
  2710. name.  (The name is also displayed on the upper screen and in the Block List
  2711. window).  A maximum of 41 characters is allowed.
  2712.  
  2713. Tracks
  2714. Selects the number of tracks in the block.  The minimum is 1 and the maximum
  2715. 64.   (The number of tracks that can be displayed on- screen at any one time
  2716. is set by Settings Menu/Display Max Tracks).
  2717.  
  2718. Note  that  track 8 onwards can only be used with MIDI devices (see the MIDI
  2719. Menu),  and tracks 4-7 only with the Channel Mode gadget in the Song Options
  2720. window set appropriately (except for MIDI use).
  2721.  
  2722. Also  note  that  when  you decrease the number of tracks, the higher tracks
  2723. will be lost (with no "Are you sure?" requester).
  2724.  
  2725. Length
  2726. The  number of lines in the block.  Can be changed by either typing in a new
  2727. number or using the arrow gadgets.  < and > decrease and increase the length
  2728. by  1,  <<  and  >>  by  10.    The preferred way is to type in a new number
  2729. directly, since less "memory fragmentation" occurs.
  2730.  
  2731. The maximum length of a block is 3200 lines.
  2732.  
  2733. Exit
  2734. Closes the window.
  2735.  
  2736.  
  2737. The Block List Window     [ Keyboard shortcut: Left Alt-B ]
  2738.  
  2739. New  to  V5.0, the block list is an "at-a-glance" list of the current song's
  2740. blocks  and their names.  It is brought up by either using the Block menu or
  2741. clicking the small "B" gadget on the upper screen.
  2742.  
  2743. The  current  block,  highlighted  in  white,  may be changed by clicking on
  2744. another block.  Keyboard shortcuts for changing the current block are:
  2745.  
  2746.         Shift - <up> / <down>      Previous / next block
  2747.         Left Alt - <up> / <down>   First block / last block
  2748.  
  2749. The text gadget displays the current block's name, which can also be changed
  2750. by typing in a new name.  Up to 41 characters are allowed in each name.
  2751.  
  2752. The window contains the following gadgets:
  2753.  
  2754. Insert New
  2755. Inserts a new block at the current block position.
  2756.  
  2757. Append New 
  2758. Inserts  a  new  block  after  the  last  block.  These gadgets are like the
  2759. New/Insert and New/Append items in the Block menu.
  2760.  
  2761. Ins to Seq
  2762. Inserts  the current block's number at the current playing sequence position
  2763. (see Playing Sequence Window).
  2764.  
  2765. App to Seq 
  2766. Appends  the  current  block's  number  to the playing sequence (see Playing
  2767. Sequence Window).
  2768.  
  2769. Delete
  2770. Deletes  the  current  block.    Equivalent to the Delete items in the Block
  2771. menu.
  2772.  
  2773. Exit
  2774. Closes the window.
  2775.  
  2776.  
  2777. The Highlight Options Window
  2778.  
  2779. In  this  window you can highlight the current block's lines in a particular
  2780. order.    This  can  help you position notes in widely-spaced blocks or mark
  2781. measures or beats.  It is opened using the Block menu.
  2782.  
  2783. The  top  row  of  small  square  gadgets highlight the block lines with the
  2784. respective spacing.  For example, the 4 gadget highlights every fourth line.
  2785. You'll  probably  use  this particular gadget (4) the most often, since in a
  2786. normal  default  block  of 64 lines, the gadget highlights every beat in the
  2787. block (i.e.  every four sixteenth notes).
  2788.  
  2789. The other gadgets are as follows:
  2790.  
  2791. Clear
  2792. Clears all the highlighted lines in the block.
  2793.  
  2794. Offset
  2795. Sets  the  first line to be highlighted.  For example, an offset of 2 begins
  2796. highlighting on line 002.
  2797.  
  2798. Spacing
  2799. Allows  a  custom highlight spacing to be entered.  For example, entering 12
  2800. highlights every twelfth line.
  2801.  
  2802. Exit
  2803. Closes the window.
  2804.  
  2805. You'll  notice  that  the  1,  2,  3, 4, 6 and 8 gadgets are all underlined,
  2806. meaning  (of  course)  that they have a Left Alt shortcut.  These shortcuts,
  2807. however,  only  work  with the numeric keypad keys (not the keys on the main
  2808. keyboard).
  2809.  
  2810. Note  that when editing, the Tab key highlights the current line.  Also note
  2811. that highlighting an already highlighted line removes the highlighting.
  2812.  
  2813. Line highlighting is saved with songs.
  2814.  
  2815.  
  2816. The Expand/Shrink Window
  2817.  
  2818. This  window,  activated  by  choosing Block Menu/Expand/Shrink, is used for
  2819. expanding or shrinking the current block.
  2820.  
  2821. The  "Expand"  gadget  creates  empty  lines between each note, and "Shrink"
  2822. removes  lines.    The  "Factor"  gadget contains the amount of expansion or
  2823. shrink.
  2824.  
  2825. For  example,  if Factor was 3, pressing Expand would insert two empty lines
  2826. between  each  note  (thus  trebling  the block length), and pressing Shrink
  2827. would remove every second and third line (thus thirding the block length).
  2828.  
  2829. "Factor"  may  be 1 - 99, but the expanded block length must not exceed 3200
  2830. lines, and the shrink factor must be divisible by the number of lines in the
  2831. block.    If  either  of  these  rules  are  infringed, a message appears to
  2832. communicate this and no change to the block occurs.
  2833.  
  2834. Expansion  is  useful,  for example, if you would like to include some quick
  2835. rhythms  in  a  block  but  realize  that the block plays too slowly for the
  2836. rhythms.    (However,  fast  rhythms may also be created using commands FF1,
  2837. FF2, FF3, and 1Fxx - see Player Commands, so try these before expanding).
  2838.  
  2839. The  only  real  use  of  shrinking  is  to reverse the effect of a previous
  2840. expansion.
  2841.  
  2842.  
  2843. The Instrument Parameters Window  [ Keyboard shortcut: Left Alt-I ]
  2844.  
  2845. With  this important window you may alter the characteristics of the current
  2846. instrument.    It  is  opened by either using the Instr menu or clicking the
  2847. "Inst Params" gadget on the upper screen.
  2848.  
  2849. The gadgets are as follows:
  2850.  
  2851. Name
  2852. Contains the name of the instrument, which may be renamed by typing in a new
  2853. name.  (However, it is advisable not to rename instruments when saving songs
  2854. without  instruments,  since  the  renamed instruments will probably fail to
  2855. load).  The maximum name length is 40 characters.
  2856.  
  2857. The  display  box  to the right of Name contains the current sample number. 
  2858. (By the way, "instrument" and "sample" essentially mean the same thing).
  2859.  
  2860. Flush
  2861. Removes  the  current  instrument from memory and clears all its parameters.
  2862. (Equivalent to Instr Menu/Flush Current).
  2863.  
  2864.  
  2865. The instrument selection gadgets
  2866. --------------------------------
  2867.  
  2868. The slider and arrow gadgets are used to select the current instrument:
  2869.  
  2870. 1st
  2871. Selects the first instrument (01).
  2872.  
  2873. Last
  2874. Selects the last instrument (1V).
  2875.  
  2876. L.U.
  2877. Selects the last instrument in memory (stands for "Last Used").
  2878.  
  2879. Keyboard shortcuts for selecting the instrument include:
  2880.  
  2881.        Shift - <left> / <right>     Previous / Next instrument
  2882.        Alt   - <left> / <right>     16 samples forward/backwards
  2883.  
  2884. Instruments  may also be selected using the numeric keypad (see the Keyboard
  2885. Options window).
  2886.  
  2887. The loop gadgets
  2888. ----------------
  2889.  
  2890. The "Repeat", "RepLen" and "Loop On" gadgets are the loop gadgets.  A sample
  2891. loop  means  that the notes you play with the sample will be sustained until
  2892. they  are  stopped.    This  is due to a particular part of the sample being
  2893. continually repeated (or "looped").
  2894.  
  2895. The Repeat value is the beginning of the loop in bytes from the start of the
  2896. sample,  and  the RepLen value is the length of the loop.  Selecting Loop On
  2897. activates the loop, and loops the whole sample if Repeat and RepLen are both
  2898. zero.    Loops  are  set in steps of 2 bytes, i.e.  only even numbers may be
  2899. used (typing in odd numbers rounds them down).  RepLen must be at least 4.
  2900.  
  2901. The  loop  may  also  be  set  by using the loop pointers and gadgets in the
  2902. sample  editor.    When   you   load   IFF   instruments,   these values are
  2903. automatically loaded.
  2904.  
  2905. The tuning gadgets
  2906. ------------------
  2907.  
  2908. Under  the loop gadgets is a cycle gadget and a slider, used for setting the
  2909. tuning  of  an  instrument.    The slider sets either the "Transpose" or the
  2910. "Finetune"  value,  depending on the state of the cycle gadget (Transpose is
  2911. default).
  2912.  
  2913. "Transpose"  raises  or  lowers  the  pitch  of  the  current  instrument in
  2914. halfsteps  (semitones).   For example, if the transpose value was 3 and note
  2915. C-2  was  to be played with the current instrument, it would be transposed 3
  2916. halfsteps  higher  (D#-2).   A negative value transposes lower.  The maximum
  2917. and  minimum  transpose values are 127 and -128 (although higher values only
  2918. affect MIDI instruments).
  2919.  
  2920. The  finetune  value allows you to tune instruments in small steps, which is
  2921. useful for incorrectly sampled instruments.  The value can be -8 to 7.
  2922.  
  2923. The two numbers separated by a "/" are the transpose and finetune values.
  2924.  
  2925. Hold and decay
  2926. --------------
  2927.  
  2928. These gadgets allow you to set the exact duration and the speed of fading of
  2929. a  note.    "Hold"  is the duration in timing pulses (see Upper Screen for a
  2930. description  of  timing pulses, you'll need it to understand this section!),
  2931. and "Decay" is the speed of fade when the hold duration has completed.
  2932.  
  2933. In  these examples, the secondary tempo is assumed to be the default 6.  One
  2934. line in the examples is one timing pulse.
  2935.  
  2936.     1. No Hold Set                        2. Hold Set To 2
  2937.     ¯¯¯¯¯¯¯¯¯¯¯¯¯¯                        ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  2938.     0  Play note (e.g. C-2 10000)         0  Play note (e.g. C-2 10000)
  2939.     1                                     1
  2940.     2                                     2  STOP note
  2941.     3                                     3  (silence)
  2942.     4                                     4
  2943.     5                                     5
  2944.     6  Play new note (e.g. D-3 10000)     6  Play new note (e.g. D-3 10000)
  2945.  
  2946. In example 2, the note is stopped on the second timing pulse.
  2947.  
  2948. BUT:  if  the  note is followed by a "keep holding symbol" in the track, the
  2949. note  is not stopped on the second timing pulse but carries on playing.  For
  2950. example:
  2951.  
  2952. 000 C-2 10000                /  Line No.  Pulse No.  Action
  2953. 001 -|- 10000               /     003         0      Continue note...
  2954. 002 -|- 10000              /      003         1      Continue note...
  2955. 003 -|- 10000 ==> ZOOMED =>       003         2      STOP note
  2956. 004 --- 00000              \      003         3      (silence)
  2957. 005 D-3 10000               \     003         4
  2958.  
  2959. So  on  the  last "keep holding symbol" encountered, the usual hold value is
  2960. used.  This symbol is inserted by either clearing the note and entering only
  2961. the instrument number, or more easily by pressing Return or the A key.
  2962.  
  2963. If  the decay is zero, the note is turned off immediately after holding.  If
  2964. it  is a non-zero value, however, the note will fade after holding.  A value
  2965. of  1  produces  the  slowest  decay.  Decay only works if Hold is non-zero.
  2966. Both Hold and Decay can have a value of 0 to 127.
  2967.  
  2968. Note  that  Decay  doesn't  work  with MIDI instruments, and is handled very
  2969. differently with synthsounds or hybrids (see Synthsound Program Language).
  2970.  
  2971. Hold  and  Decay  is  quite  a  useful  feature,  and  although it may sound
  2972. complicated,  it isn't really :-), so we recommend that you learn to use it!
  2973.  
  2974.  
  2975. Default volume and  pitch
  2976. -------------------------
  2977.  
  2978. The  "Volume"  gadget sets the default volume of the current instrument.  It
  2979. ranges from 0 (silent) to 64 (full volume).
  2980.  
  2981. "Default  Pitch"  allows  you  to  set  a  default  pitch  for   the current
  2982. instrument.    When  you  press  the  F key the instrument is played at that
  2983. pitch.  This can be very useful for untuned instruments like percussion.
  2984.  
  2985. The  pitch  box  contains  the default pitch of the instrument (or --- if no
  2986. pitch  is  set).  To change this, hold down the left mouse button on the box
  2987. and  press a note on the keyboard.  You may also clear the pitch by pressing
  2988. Return or Del.
  2989.  
  2990. MIDI gadgets  (see the MIDI Menu and MIDI Commands)
  2991. ---------------------------------------------------
  2992.  
  2993. Before  using  a MIDI instrument, you need to set the functions in this part
  2994. of the window to the required values.  They are:
  2995.  
  2996. MIDICh
  2997. This slider sets the MIDI channel for the instrument (0 - 16).  For example,
  2998. setting  it to 5 means this instrument's notes are sent through MIDI channel
  2999. 5.
  3000.  
  3001. Preset
  3002. Sets the preset number of the instrument (max. 128 or 2800).
  3003.  
  3004. With  this  set to zero, OctaMED uses your keyboard's default preset for the
  3005. instrument's MIDI channel (see above).  But by giving this gadget a non-zero
  3006. value, you may use more than one preset on the same channel: OctaMED sends a
  3007. program change message whenever a note is played.
  3008.  
  3009. If  you want to send a preset change command without playing a note, use the
  3010. C00 command with any note played by the instrument with the new preset.
  3011.  
  3012. Suppress NoteOff
  3013. Suppresses  Note  Off messages for the current instrument.  Some devices may
  3014. have some instruments (e.g.  one-shot drum sounds) which actually ignore the
  3015. Note  Off  messages.    When this is selected, Note Offs aren't sent for the
  3016. current  instrument,  reducing  unnecessary  output  (and therefore slightly
  3017. faster).
  3018.  
  3019. Extended Preset
  3020. When  off,  the  maximum  value of the Preset gadget is 128, but when on the
  3021. maximum  is  increased to 2800.  However, this can only be used on some MIDI
  3022. devices which support the exact method of sending the preset:
  3023.  
  3024. * Presets 1 - 100 are sent in the normal manner.
  3025.  
  3026. * Presets  above 100 are sent by first sending the "hundreds" part and then
  3027.   the 0-99 part.  For example, the number 1156 is sent as 11 followed by 56.
  3028.  
  3029. Consult your manual to see if this is the way supported by your device.
  3030.  
  3031. In order to hear a MIDI instrument, you must also set its default volume.
  3032.  
  3033. Note:  a  MIDI  instrument's  name  doesn't  really have any use.  It's good
  3034. practice,  however,  to  type the name of the presets into the Name gadget. 
  3035. This way you can easily see the presets, and if you give the song to someone
  3036. else  who  may have different MIDI equipment, he / she can easily change the
  3037. preset numbers to use the correct presets on his / her MIDI device.
  3038.  
  3039. **  The loop, tuning, default volume, and MIDI values, and the default pitch
  3040.     can  all  be  set  in  the  path file using the sample list editor.
  3041.  
  3042.  
  3043. The Instrument Type Window   [ Keyboard shortcut: Left Alt-T ]
  3044.  
  3045. This window, brought up either by using the Instr menu or by clicking "Type"
  3046. on  the  upper  screen,  chooses which type the current instrument is to be.
  3047. The options are:
  3048.  
  3049. Sample
  3050. The  "normal"  instruments, played either through the Amiga® or using a MIDI
  3051. device.
  3052.  
  3053. OctaMED  can load both "raw" (pure binary) samples and IFF 8SVX 1 - 7-octave
  3054. samples.    In  addition  to these, OctaMED Pro V4 introduced the loading of
  3055. "delta-compressed"  samples.   These samples' lengths are exactly halved (in
  3056. fact  they  are  converted  to a kind of 4-bit resolution of Fibonacci delta
  3057. codes:  much  simpler than it sounds!).  There is, however, a slight loss in
  3058. sound  quality.    Currently  OctaMED can't actually create delta-compressed
  3059. samples,  but some dedicated sample editor programs such as Audiomaster can.
  3060.  
  3061. Note  that  raw and 1-octave IFF samples can only use octaves 1 - 3: octaves
  3062. higher  than  3  play  using  octave  3's range.  Also note that the highest
  3063. octave of a 7-octave sample can't be played.
  3064.  
  3065. For MIDI use, the instrument is not strictly an instrument, but simply a few
  3066. settings  which  result  in the notes played with that instrument being sent
  3067. through  a  MIDI  interface;  therefore, MIDI instruments aren't loaded into
  3068. memory  like  other sounds.  They can also use the full 10.5-octave range.  
  3069. (For more information on MIDI, see MIDI Menu and Instr Params)
  3070.  
  3071. Hybrid
  3072. As  "Sample"  above,  but  can  be  controled  using  the  same "programming
  3073. language"  as  synthsounds.   (See the Synthetic Sound Programming Language.
  3074.  
  3075. ExtSample
  3076. ExtSamples  are  like  normal  Amiga®  samples, except two lower octaves are
  3077. added  to  the octave range (octaves 1 and 2).  The octaves used with normal
  3078. samples  are  moved  up  two  places  to  make way for the new octaves (i.e.
  3079. octave 1 becomes octave 3, octave 2 becomes octave 4 etc.).
  3080.  
  3081. However,  because  of  an  undesirable  feature  in  the  Amiga®'s hardware,
  3082. especially  under  faster  processors,  ExtSamples should be used with care.
  3083. After  playing  a  note  with an ExtSample using one of the new octaves, the
  3084. following  note  will  often not be correctly triggered.  The solution is to
  3085. use the FFF command before the following note is played.  For example:
  3086.  
  3087.              C-1 20000 <- ExtSample
  3088.              --- 00000
  3089.              --- 00FFF <- use FFF before the next note
  3090.              C-2 10000 <- this instrument doesn't need to be an ExtSample
  3091.                           for the bug to occur
  3092.  
  3093. However,  in  "split"  channels  in  5-8-channel  mode, this problem doesn't
  3094. appear at all!
  3095.  
  3096. Note:  more  experimentative  users  may  discover that octaves 8 and 9 of a
  3097. normal  sample also appear to play two lower octaves.  These octaves should,
  3098. however, *NEVER* be used in songs (apart from with MIDI): believe it or not,
  3099. it  is  in  fact  a complete coincidence that they work!  ExtSamples are the
  3100. only "legal" way of using the two lower octaves.  In any case, octaves 8 and
  3101. 9 are also one finetune step sharp :-)
  3102.  
  3103. Synthetic
  3104. These  special  instruments,  known  as  "synthsounds", are made from simple
  3105. waveforms  which  can  be  joined  together  and have their volume and pitch
  3106. altered by using a simple "programming language".  Synthsounds usually sound
  3107. quite  simple,  but  they  can be very effective and don't take up nearly as
  3108. much  memory as normal samples.  In addition, they can play from octaves 1 -
  3109. 5,  two  octaves  greater  than  normal  samples.  For more details, see the
  3110. Synthetic Sound Editor.
  3111.  
  3112. The  Octaves  slider  shows  the  number  of octaves that the current sample
  3113. consists  of  (1  -  7).    Changing  the slider's value often messes up the
  3114. sample, so it's best not to :^)
  3115.  
  3116. The Exit gadget closes the window.
  3117.  
  3118.  
  3119. The Transpose Window   [ Keyboard shortcut: Amiga-T ]
  3120.  
  3121. This  window  contains  functions that "transpose" (change the pitch of) the
  3122. notes  in  a  particular area of the current project.  It is activated using
  3123. the Edit menu.
  3124.  
  3125. The  gadgets  under "Affect" choose which area of the song the transposition
  3126. should  affect,  and  the  notes played by which instruments.  These gadgets
  3127. should be selected before choosing a function, and are:
  3128.  
  3129. Song
  3130. Affects the whole song (default).
  3131.  
  3132. Block
  3133. Affects the current block.
  3134.  
  3135. Track
  3136. Affects the current track (the track that the cursor is on).
  3137.  
  3138. Selected Tracks
  3139. Affects  selected  tracks  (tracks  are  selected by setting the track cycle
  3140. gadget on the upper screen to "Select").
  3141.  
  3142. Range
  3143. Affects  the  range,  selected  using the mouse.  (The button used to mark a
  3144. range is chosen in the Mouse Options window).
  3145.  
  3146. All
  3147. Affects all instruments (default).
  3148.  
  3149. Current
  3150. Affects the currently selected instrument.
  3151.  
  3152. The  "Transpose"  functions are Octave Up / Down and Halfstep Up / Down, and
  3153. should  be  self-explanatory.    (Note  to  British  users: "halfstep" means
  3154. "semitone").
  3155.  
  3156. The "Change Notes" operations act on the Source and Destination notes, which
  3157. are  selected  by clicking and holding the left mouse button on the note box
  3158. and pressing a key (for example, the I key selects note C-3).
  3159.  
  3160. Change
  3161. Allows  occurrences  of a single note to be changed throughout the specified
  3162. area.  It changes all notes in the selected area from the source note to the
  3163. destination note.
  3164.  
  3165. Swap
  3166. Swaps all source notes in the selected area with the destination note.
  3167.  
  3168. The  "Change Instrument" functions perform on notes played by the Source and
  3169. Destination  instruments,  which  are  picked  by   selecting   the required
  3170. instrument  (using  Shift  - <left> / <right> etc.) and clicking "Source" or
  3171. "Destination".
  3172.  
  3173. Change
  3174. Changes  the notes (in the selected area) played by the source instrument to
  3175. the destination instrument.
  3176.  
  3177. Swap
  3178. Swaps  the source and destination instrument numbers of notes having either.
  3179.  
  3180.  
  3181. Delete
  3182. Deletes the notes with the source instrument number.
  3183.  
  3184.  
  3185. The Spread Notes Window   [ Keyboard shortcut: Amiga-F ]
  3186.  
  3187. This  window  allows  you  to spread the notes in the currently marked range
  3188. across consecutive tracks to the right of the range.  If notes already exist
  3189. in  the tracks, the operation replaces them.  The window is opened using the
  3190. Edit menu.
  3191.  
  3192. The  "Width"  slider selects the number of tracks to spread the notes across
  3193. (2 - 10).
  3194.  
  3195. Clicking "Spread" spreads the notes, and shift-clicking "Spread" spreads the
  3196. notes _and_ closes the window.
  3197.  
  3198. "Exit" closes the window.
  3199.  
  3200.  
  3201. The Note Echo Window   [ Keyboard shortcut: Amiga-E ]
  3202.  
  3203. With  this  window,  opened  using  the  Edit  menu,  you may produce echoes
  3204. automatically  with  the "C" command (see Commands A - F.  The volume halves
  3205. with each echo.  For example:
  3206.  
  3207.         C-1 10000   (the initial note)
  3208.         --- 00000
  3209.         C-1 10C32   (half volume. Decimal volumes are used in this example)
  3210.         --- 00000
  3211.         C-1 10C16   (quarter volume)
  3212.         --- 00000
  3213.         C-1 10C08   (eighth volume)
  3214.         ...
  3215.  
  3216. Echoed  notes  will  only  be  placed in empty note positions throughout the
  3217. marked range.  The range may cover more than one track.
  3218.  
  3219. The gadgets are as follows:
  3220.  
  3221. Distance
  3222. The  distance in lines between echoes, e.g.  4 means echo every fourth line.
  3223.  
  3224. Minimum Volume
  3225. The minimum volume of an echo.  Echoes with a smaller volume than this won't
  3226. be generated.
  3227.  
  3228. Do Echo
  3229. Creates the echo. (Shift-clicking it also closes the window).
  3230.  
  3231. Exit
  3232. Closes the window.
  3233.  
  3234.  
  3235. The Input Channel Window   [ Keyboard shortcut: Amiga-\ ]
  3236.  
  3237. This  small  window,  activated using the MIDI menu, contains the MIDI input
  3238. channel  number  through  which  notes will be received when MIDI Menu/Input
  3239. Active is on.
  3240.  
  3241. If it is zero, OctaMED will accept input from all MIDI channels.
  3242.  
  3243.  
  3244. The Mouse Options Window     [ Keyboard shortcut: Amiga-W ]
  3245.  
  3246. This  window  contains  three  cycle  gadgets,  which are used to select the
  3247. function  of  each  mouse  button  when the button is clicked in the Tracker
  3248. editor.  It is opened using the Settings menu.
  3249.  
  3250. The available functions are as follows:
  3251.  
  3252. No Operation
  3253. The button has no effect.
  3254.  
  3255. Track On/Off
  3256. The button switches the clicked track on or off.
  3257.  
  3258. Select Track
  3259. Switches  the  clicked  selected  track  on or off.  (The status of selected
  3260. tracks  are  displayed  by  setting  the cycle gadget on the upper screen to
  3261. "Select").
  3262.  
  3263. Position Cursor
  3264. Sets the cursor position under the mouse pointer.
  3265.  
  3266. Select Range
  3267. Marks a range. (See the Tracker Editor)
  3268.  
  3269. Note: due to conflicts with the menu system, the right mouse button can't be
  3270. used to select a range as it has done in previous versions of (Octa)MED.
  3271.  
  3272. Also  note  that  if  the Right Mouse Button gadget is set to anything other
  3273. than  "No  Operation",  the menu shortcuts (Right Amiga + key) can't be used
  3274. when  the mouse pointer is over the tracker editor.  (They instead act as if
  3275. the right mouse button has been pressed: OctaMED has no control over this!)
  3276.  
  3277. The  default  for Left Mouse Button is Select Range, and the default for the
  3278. other  gadgets  is No Operation.  Of course, the Middle Mouse Button setting
  3279. is ignored if you own a two-button mouse!
  3280.  
  3281. The Exit gadget closes the window.
  3282.  
  3283.  
  3284. The Keyboard Options Window  [ Keyboard shortcut: Amiga-K ]
  3285.  
  3286. This  window contains many settings used when editing in the Tracker editor,
  3287. and  also holds settings for the numeric keypad.  It is brought up using the
  3288. Settings menu.
  3289.  
  3290. Cursor advance
  3291. --------------
  3292.  
  3293. The  three  gadgets  at  the top of the window are the directions the cursor
  3294. should advance after entering something in the editor.  They are:
  3295.  
  3296. Line Up / Down
  3297. Advances up / down a line.
  3298.  
  3299.             [ Ctrl-A toggles Don't Advance / Down ]
  3300.  
  3301. Track Prev / Next
  3302. Advances to the previous / next track when the cursor is on the note.
  3303.  
  3304. Cursor Left / Right
  3305. Advances left / right when the cursor is on the command digits.
  3306.  
  3307. Advance Line Down is the usual preferred setting, and the default.
  3308.  
  3309.  
  3310. Numeric keypad mapping  (Amiga 600 owners may ignore this section)
  3311. ------------------------------------------------------------------
  3312.  
  3313. The two cycle gadgets select a total of four different ways to configure the
  3314. function of the keypad.
  3315.  
  3316. The  first gadget cycles "Tracks On/Off" and "Select Instr".  With the first
  3317. option you may turn tracks 0-F or 0-9 on/off, and with the second option you
  3318. can select instruments quickly.
  3319.  
  3320. The  second  gadget  selects  the  "Normal"  or  "Alternative" layout of the
  3321. keypad, and are as follows:
  3322.  
  3323.      Normal layout (button = selects track no. / selects instrument no.)
  3324.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3325.         ( = 0 / 01      ) = 1 / 02      / = 2 / 03      * = 3 / 04
  3326.         7 = 4 / 05      8 = 5 / 06      9 = 6 / 07      - = 7 / 08
  3327.         4 = 8 / 09      5 = 9 / 0A      6 = A / 0B      + = B / 0C
  3328.         1 = C / 0D      2 = D / 0E      3 = E / 0F      . = F / 0G
  3329.  
  3330.      Alternative layout - Tracks On/Off
  3331.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3332.         Keys 0 - 9      Turn tracks 0 - 9 on/off.
  3333.         Keys ( ) / *    Turn tracks A - D on/off.
  3334.         The . key       Turns all tracks off.
  3335.         Enter key       Turns all tracks on.
  3336.  
  3337.      Alternative layout - Select Instr
  3338.      ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  3339.         Keys 1 - 9      Selects instruments 1 - 9
  3340.         The . key       Changes the first instrument digit (for example,
  3341.                           from 05 to 15 or from 15 to 05)
  3342.            '0'          Selects instrument 10
  3343.            '+'          Next instrument
  3344.            '-'          Previous instrument
  3345.            '('          Decrease volume of the current instrument by one
  3346.            ')'          Increase volume of the current instrument by one
  3347.            '/'          Select last used instrument
  3348.            '*'          Pick instrument number nearest the cursor
  3349.           Enter         Activates "alpha-enter": after pressing Enter,
  3350.                           press an alphabetical key (A - V) to select the
  3351.                           corresponding instrument
  3352.  
  3353. Default is Alternative Tracks On/Off.
  3354.  
  3355. Spacing  (see Upper Screen)
  3356. ---------------------------
  3357.  
  3358. The  slider  sets  the space value.  A space value of 3, for example, enters
  3359. notes every third line.  The maximum value is 16 (and minimum 2).
  3360.  
  3361. Placing  spaces  between  notes while entering music makes editing and tempo
  3362. changes  much easier.  After you have entered the music you may want to turn
  3363. this spacing function off so you may move into the lines between notes.
  3364.  
  3365. Other spacing options are:
  3366.  
  3367. Destructive Spacing
  3368. When selected, any notes that lie between the lines used for entering spaced
  3369. notes will be deleted when a note is entered.
  3370.  
  3371. Auto-Round Spacing
  3372. When on, restricts cursor movements to lines divisible by the spacing value.
  3373. For  example,  with  a  spacing  value of 2, you can only move the cursor to
  3374. lines  000, 002, 004 etc.  Note that this only applies to movement using the
  3375. cursor keys.
  3376.  
  3377. By  default these two options are on, which has been the normal operation in
  3378. previous versions of OctaMED.
  3379.  
  3380. Other options
  3381. -------------
  3382.  
  3383. Chord Reset
  3384. When on, after entering a chord (see Upper Screen) the cursor returns to the
  3385. initial track.
  3386.  
  3387. Space = DEL
  3388. Some users prefer using the space bar to enter blank notes, in preference to
  3389. the Del key.  This check box allows this.
  3390.  
  3391. Protracker Shortcuts
  3392. This  switch  changes the keyboard layout so that the most common Protracker
  3393. keyboard  options are recognized.  This is helpful for those who have become
  3394. used  to  the  Protracker  keyboard  layout.  The following PT shortcuts are
  3395. recognized:
  3396.  
  3397.            Right Shift      Turns editing on, plays the block (record)
  3398.            Right Alt        Continue Song
  3399.            Right Amiga      Play Block
  3400.            L-Alt+curs.L/R   Previous / next block
  3401.            Shift+curs.L/R   Increase / decrease playseq position
  3402.            Space bar        Stops playing / toggles editing
  3403.            Tab              Next track
  3404.            Shift-Tab        Previous track
  3405.            Shift-F3 - F5    Cut / Copy / Paste track
  3406.            Alt-F3 - F5      Cut / Copy / Paste block
  3407.  
  3408. Advance with Sound
  3409. When  activated,  the notes in the block are played when the cursor is moved
  3410. up or down.  Useful for non-real time editing.
  3411.  
  3412.  
  3413. The Programmable Keys Window  [ Keyboard shortcut: Amiga-Y ]
  3414.  
  3415. The  programmable  keys  ("progkeys"  from now on) allow music to be entered
  3416. much  more  easily  and  quickly.   You can assign notes or groups of notes,
  3417. including  commands,  to  10 different keys.  The assigned notes can then be
  3418. inserted in the Tracker editor by holding down Shift and pressing key 0 - 9.
  3419.  
  3420. This  window contains the functions necessary to view and edit the progkeys,
  3421. and is opened using the Settings menu.
  3422.  
  3423. The  cycle  gadget  is  used  to  select whether you wish to edit the normal
  3424. Shift-  0  - 9 definitions (default) or the Right Alt definition.  The Right
  3425. Alt  definition  consists of the command digits only, and if you enter notes
  3426. with  the  Right  Alt  key held in the Tracker editor, the specified command
  3427. will be inserted with the notes.
  3428.  
  3429. The  slider to the right of the cycle gadget selects which progkey you would
  3430. like  to edit (0 - 9).  By default key 1 is selected.  The slider is ghosted
  3431. when "Right Alt" is picked.
  3432.  
  3433. The  box below this, containing a note and command digits, is the definition
  3434. of  this progkey.  A note or digit may be edited by clicking and holding the
  3435. left  mouse  button  on  the note / digit, then entering a new note / number
  3436. using the keyboard.
  3437.  
  3438. A  note  /  digit being "x" indicates "transparency", which means that, when
  3439. entered  in the Tracker editor, the corresponding existing note / digit will
  3440. remain  unchanged.   The Right Alt key's definition always has a transparent
  3441. note part (the first three characters).
  3442.  
  3443. For  example, the definition "xxxxx0000" would clear the command digits, but
  3444. leave  the  notes.   Since the note is "xxx" and the instrument number "xx",
  3445. they won't be changed, so only the command is set to zero.  (This definition
  3446. is the same as pressing Alt-Del).
  3447.  
  3448. To make a note / digit transparent, hold down the left mouse button over the
  3449. required note / digit as above, then press the Return key.
  3450.  
  3451. The Clear gadget clears the current definition, i.e.  sets it to "--- 00000"
  3452. for a normal progkey and to "xxxxx0000" for Right Alt.
  3453.  
  3454. The  Pick  gadgets copy either the note under the cursor, the current range,
  3455. or  the  copy  buffer  to the current definition.  If a range is picked, the
  3456. definition  box  shows the word "=Range=".  [ Shortcut: Shift-Ctrl-0-9 picks
  3457. note under cursor ]
  3458.  
  3459. The  Save/Load  Keys  gadgets open a file requester allowing you to save and
  3460. load a set of progkey definitions.  The default name is S:OctaMEDPro.defkeys
  3461. (OctaMED  attempts  to load a file of this name on startup), but definitions
  3462. can be saved under any filename.
  3463.  
  3464. The Exit gadget closes the window.
  3465.  
  3466. (Note:  when Caps Lock is on, the programmable keys may be entered simply by
  3467. pressing the 0 - 9 keys: Shift doesn't have to be held).
  3468.  
  3469.  
  3470. The Palette Window
  3471.  
  3472. With  this  window,  activated  using  the Settings menu, you may change the
  3473. screen's colors.
  3474.  
  3475. A  color  is  selected by clicking on it, with the chosen color appearing in
  3476. the recessed box at the top left of the window.
  3477.  
  3478. The  Red,  Green and Blue sliders alter the intensity of red, green and blue
  3479. light in the selected color.
  3480.  
  3481. The  sliders'  range is set using the Palette Type cycle gadget.  With 8-Bit
  3482. selected  (default),  the  range is 0 - 255, allowing compatibility with the
  3483. new  AGA  chip  set  present  in  the A1200 and A4000 computers.  With 4-Bit
  3484. selected, the range is 0 - 15, more suitable for use with older Amigas.
  3485.  
  3486. Note  that  either  setting  can  be  used with either chip set; but with an
  3487. inappropriate  setting,  AGA  computers  could  only  select 1 in every 4096
  3488. available  colors, and with other computers the color would only change once
  3489. every 16 slider values (which is a little uncomfortable!).
  3490.  
  3491. The  OK  and Cancel gadgets accept or reject the color changes and close the
  3492. window.
  3493.  
  3494.  
  3495. The Instrument Load Window
  3496.  
  3497. This  window,  activated  using the small gadget immediately to the right of
  3498. the  instrument  number  on the upper screen, is a convenient way of loading
  3499. instruments contained in the sample list.  (See the Sample List Editor.
  3500.  
  3501. The  right-hand  list  contains  the  directories,  and  the  left-hand list
  3502. contains  the  filenames in the current directory.  The current directory is
  3503. set  by  clicking  on a directory name, and an instrument is loaded into the
  3504. current slot by clicking on an instrument name.
  3505.  
  3506. The other gadgets in this window are:
  3507.  
  3508. Flush
  3509. Removes the current instrument from memory.
  3510.  
  3511.            [ Keyboard shortcut: Ctrl - G ]
  3512.  
  3513. Prev / Next Inst
  3514. Selects the previous / next instrument.
  3515.  
  3516.            [ Keyboard shortcuts: Shift - <left> / <right>
  3517.  
  3518. Prev / Next Free
  3519. Selects the previous / next empty instrument slot.
  3520.  
  3521.           [ Keyboard shortcuts: Shift - Ctrl - "<" / ">" ]
  3522.  
  3523. Exit         Closes the window.
  3524.  
  3525.  
  3526. The Main Screen
  3527.  
  3528. The main screen is split into several parts:
  3529.  
  3530. Tracker editor 
  3531. Notation editor
  3532. Upper screen   
  3533. Lower screen   
  3534.  
  3535. Note  that  EITHER the Tracker editor OR the notation editor is displayed in
  3536. the  middle  of  the  screen  (not  both  at  once).   Which editor is to be
  3537. displayed is chosen in the Display menu
  3538.  
  3539.  
  3540. The Tracker Editor
  3541.  
  3542. OctaMED  Pro started off its life as MED, a public domain clone of a program
  3543. named  "Sound  Tracker".    Although  as  MED  grew it incorporated numerous
  3544. features  that Sound Tracker lacked, separating it from the competition, one
  3545. basic feature remains that Sound Tracker pioneered: the Tracker editor.
  3546.  
  3547. The Tracker editor notation is easily interpreted by the computer and allows
  3548. controls  that  would be impossible to describe using a traditional notation
  3549. system.    It is a grid-like system, where the rows are known as "lines" and
  3550. the columns "tracks".
  3551.  
  3552. Assuming  a  standard  4-track,  non-MIDI  setup  is  being used, each track
  3553. corresponds to one of the Amiga®'s "sound channels", of which the Amiga® has
  3554. four.    These  sound  channels  are  used for playing instruments, and each
  3555. channel  can  only  play one note at a time.  So using the above setup, four
  3556. notes  can  be  played  simultaneously  (not  necessarily  all  by  the same
  3557. instrument).    This  is  not  as  limiting  as it sounds: in practice, many
  3558. instruments can share a single track.
  3559.  
  3560. The  exact time at which these notes are played is set by entering the notes
  3561. on the appropriate line.  When playing, OctaMED plays each of these lines in
  3562. turn,  with  a  user-defined pause between the playing of each line.  So the
  3563. greater the number of lines between notes, the greater the time span between
  3564. them.  The line numbers are displayed on the extreme left of the screen, and
  3565. the current line is highlighted in white.
  3566.  
  3567. A typical note looks like this:
  3568.  
  3569.                            octave  command digits
  3570.                             |     / |
  3571.                         D # 3   5 0 C 2 0
  3572.                         \ |     |     \ |
  3573.                          note   |      \|
  3574.                                 |       data byte (more information
  3575.                           instrument    about the command digits)
  3576.  
  3577. The  note  can  be C, C#, D, D#, E, F, F#, G, G#, A, A#, and H (or B), as in
  3578. standard music.  The octave number is which octave the note should be played
  3579. on, and three octaves can be used with normal Amiga® samples.
  3580.  
  3581. The  instrument  number is the number of the instrument that the note should
  3582. be played with.
  3583.  
  3584. The  command  digits  are  the  number  of the command or effect to play, in
  3585. hexadecimal.   If there are no effects or commands for this particular note,
  3586. the  digits  are  "0000".    Commands  and  effects are documented in Player
  3587. Commands.
  3588.  
  3589. A blank note (silence) looks like this: --- 00000.
  3590.  
  3591. Now  for  a  few  examples.    To  play a C major chord (notes C, E, G) with
  3592. instrument number 1, a line could look like this:
  3593.  
  3594.                 000 C-2 10000  E-2 10000  G-2 10000  --- 00000
  3595.                 |                                          |
  3596.       line number      "blank" note simply indicates no note on this track
  3597.  
  3598. To  play  a  C  major  scale  from  C  to G (i.e.  notes C, D, E, F, G), the
  3599. following could be used:
  3600.  
  3601.                         000 C-2 10000
  3602.                         001 D-2 10000
  3603.                         002 E-2 10000
  3604.                         003 F-2 10000
  3605.                         004 G-2 10000
  3606.  
  3607. To  play a C major scale from C to G AT HALF THE SPEED of the above example,
  3608. this could be used:
  3609.  
  3610.                         000 C-2 10000
  3611.                         001 --- 00000 <= In this way, these blank notes
  3612.                         002 D-2 10000    are used as "spacers" between the
  3613.                         003 --- 00000 <= other notes. A blank note doesn't
  3614.                         004 E-2 10000    stop the previous note, it allows
  3615.                         005 --- 00000 <= it to carry on. To stop the note,
  3616.                         006 F-2 10000    player command FFF is used (see
  3617.                         007 --- 00000 <= Commands A - F).
  3618.                         008 G-2 10000
  3619.  
  3620. So  in that instruments are triggered using a vertical list, Tracker editing
  3621. somewhat resembles programming a drum machine.
  3622.  
  3623.  
  3624. Entering notes
  3625. --------------
  3626.  
  3627. Notes  are  usually entered using the Amiga®'s keyboard (a MIDI keyboard can
  3628. also  be  used, see MIDI Menu.  Not all keys will enter notes.  The keys are
  3629. ordered  in a piano-like style, as follows (note that the keys correspond to
  3630. the  standard U.S.  keyboard; users of other keyboards should refer to their
  3631. Amiga®'s manual for any changes needed):
  3632.  
  3633.          2 3   5 6 7   9 0   = \    (Notes C# D# F# G# A# C# D# F# G#)
  3634.         Q W E R T Y U I O P [ ]     (Notes C D E F G A B C D E F G)
  3635.  
  3636.           S D   G H J   L ;         (Notes C# D# F# G# A# C# D#)
  3637.          Z X C V B N M , . /        (Notes C D E F G A B C D E)
  3638.  
  3639. The  upper two rows of keys are the upper octave, the lower two rows of keys
  3640. are  the  lower octave.  Note that keys to the right of the "U" key enter in
  3641. an  even  higher octave, and that there is a slight overlap in the lower and
  3642. upper  octaves:  the  keys to the right of the "M" key are duplicated in the
  3643. first few keys of the upper octave.
  3644.  
  3645. The  upper  and lower octave "keyboards" represent octave numbers 1 and 2 by
  3646. default.  Other consecutive octave numbers can be selected using the octaves
  3647. cycle gadget on the upper screen.
  3648.  
  3649. If  you  have an instrument loaded into the current slot, you can hear it by
  3650. pressing  one  of  these keys.  In addition, if editing is on (selected with
  3651. the  Edit  gadget on the upper screen, the note is entered at the cursor.  A
  3652. blank note is entered using the Del key.
  3653.  
  3654. The cursor is the small grey patch on the current line.  As well as being on
  3655. a  note,  it  may  be  on a digit (to the right of the note), and digits are
  3656. changed by simply by typing the new number (with editing on).
  3657.  
  3658. If  you  need to change the sixth digit (which lies between the note and the
  3659. second  instrument  digit,  and  is usually a blank space), which means that
  3660. sample 10 - 1V is used, position the cursor over the second instrument digit
  3661. (that  is  always visible), hold a Shift key and enter the second instrument
  3662. digit.   For example, to change the instrument number to 1E, press Shift-E. 
  3663. Because  Shift-  0  -  9 have another use, use Alt-Shift-0 - 9 to change the
  3664. instrument  number  to  10 - 19.  This isn't very convenient, but songs with
  3665. over 31 instruments are rare, so it is seldom a serious problem.
  3666.  
  3667. The  cursor  can  be  moved  using  the cursor keys, and also by using these
  3668. keyboard shortcuts:
  3669.  
  3670.         Alt - <left> / <right>        = Previous / next track
  3671.         Ctrl - <left> / <right>       = Previous / next screenful of tracks
  3672.         Shift - Ctrl - <left / right> = Track 0 / last track
  3673.  
  3674.         Shift - <up>        = Previous block (see the next section for a
  3675.         Shift - <down>      = Next block      description of blocks)
  3676.         Left Alt - <up>     = First block
  3677.         Left Alt- <down>    = Last block
  3678.  
  3679.         Ctrl - NM(          = Previous song
  3680.         Ctrl - NM)          = Next song / Add song
  3681.         Shift - Ctrl - NM(  = Delete last song
  3682.         Shift - Ctrl - NM)  = Add song with no requester
  3683.  
  3684.         F6   =  First line of block
  3685.         F7   =  Second quarter of block
  3686.         F8   =  Middle of block
  3687.         F9   =  Last quarter of block
  3688.         F10  =  Last line of block
  3689.  
  3690.  
  3691. Blocks and the playing sequence
  3692. -------------------------------
  3693.  
  3694. As  mentioned  in the introduction, a song is made up of "blocks", which are
  3695. simply  defined numbers of tracks and lines.  A block can contain up to 3200
  3696. lines,  and up to 8 tracks (using the Amiga®'s internal sound chip) or up to
  3697. 64  tracks  (using  a MIDI instrument).  You can set the number of lines and
  3698. tracks  in  each block using the Block Properties window.  There can be 1000
  3699. blocks in a song (numbered 000 - 999).
  3700.  
  3701. The default number of lines in a block is 64, which allows 4 measures of 4/4
  3702. time,  and  means that each line represents a sixteenth note (British users:
  3703. sixteenth  note  =  semiquaver).    Notes may be more easily positioned in a
  3704. block  by  using  line  highlighting  in  the  Highlight Options window (for
  3705. example, with a default block a highlighting of 4 would mark every beat).
  3706.  
  3707. Again  as  touched  on  in the introduction, the order in which these blocks
  3708. should  be  played  is  defined in the "playing sequence", which is simply a
  3709. list  of  block  numbers.    (See  the  Playing   Sequence   window for more
  3710. information).
  3711.  
  3712. Each  block may have its own name, and block names may be edited both in the
  3713. Block Properties window and in the Block List window.  The current block and
  3714. its name is shown on the upper screen.
  3715.  
  3716. A  list  of  blocks  and their names, and gadgets for inserting and deleting
  3717. blocks can be found in the Block List window.
  3718.  
  3719.  
  3720. The Range
  3721. ---------
  3722.  
  3723. A  "range" is a rectangular area of notes that is marked by dragging a mouse
  3724. button.   (Which mouse button is used is chosen in the Mouse Options window.
  3725. It may be as small as one note or as large as an entire block.  The range is
  3726. highlighted as you define it.
  3727.  
  3728. Many editing functions act on the notes in the current range, including some
  3729. in the Edit menu, Transpose window, and Programmable Keys window.
  3730.  
  3731. A  range  can  be canceled by simply clicking the chosen mouse button when a
  3732. range is marked.  This is useful, for example, if you have pressed the mouse
  3733. button by mistake.
  3734.  
  3735.  
  3736. The Notation Editor
  3737.  
  3738. The notation editor, activated using the Display menu, offers an alternative
  3739. to  the  normal  Tracker editor.  It can display notes and rests in standard
  3740. musical  notation,  which  is  both  useful for those who read music and for
  3741. printing songs to be played on an external instrument.
  3742.  
  3743. Note, however, that although notes can be entered using the notation editor,
  3744. player commands and effects may only be entered using the Tracker editor.
  3745.  
  3746. One  line  of  the  Tracker  editor is displayed in the notation editor as a
  3747. sixteenth  note,  so  a quarter note would be four lines long in the Tracker
  3748. editor.  The notation editor displays and prints one measure at a time.
  3749.  
  3750. The  notation editor consists of the notation itself on the main screen, and
  3751. a  Notation  Control  window  which  contains various editing options.  This
  3752. window may be closed using its close gadget, then reopened using the Display
  3753. menu.
  3754.  
  3755. Note  that  when  the notation editor screen is active, the mouse pointer is
  3756. displayed  as  the  current note instead of the default pointer symbol.  The
  3757. pointer's "hotspot" (the pixel used to "point" the pointer) is in the note's
  3758. circle, not at the top of the note's stick.  So for example, to click on the
  3759. Play  Block  gadget in the upper screen, position the note's circle (not the
  3760. top of the note's stick) over the gadget and press the left mouse button.
  3761.  
  3762. Selecting displayed tracks
  3763. --------------------------
  3764.  
  3765. The  editor  quickly becomes cluttered if all tracks are displayed at once. 
  3766. For  this  reason, you can select exactly which tracks should be displayed. 
  3767. This is achieved with the three rows of small square track gadgets:
  3768.  
  3769. Shown
  3770. Simply select which tracks are to be shown.
  3771.  
  3772. Ghost
  3773. Show the tracks in a "ghosted" (semi-visible) form.
  3774.  
  3775. Select
  3776. Clicking  a  track  gadget clears all Shown tracks except the track clicked,
  3777. and ghosts the tracks that were previously shown.
  3778.  
  3779. The  two  large arrow gadgets to the right of the track gadgets operate like
  3780. the  track  arrow  gadgets  on  the  upper  screen  - clicking them show the
  3781. previous/next  fourteen  tracks, and shift-clicking them show the first/last
  3782. fourteen  tracks  in the song.  (They only really apply to blocks containing
  3783. over fourteen tracks).
  3784.  
  3785. Presets
  3786. -------
  3787.  
  3788. You  can  choose five different combinations of selected and ghosted tracks,
  3789. and select them using the Preset cycle gadget immediately to the left of the
  3790. track gadgets.  The default is preset number 1.
  3791.  
  3792. Usually  it's convenient to put different components of the song on the same
  3793. tracks  throughout  the song.  For example, drums and percussion could be on
  3794. tracks  0  and  1, the bass line on track 2, the chords on tracks 3-5 and so
  3795. on.    Using  the preset function you can quickly display different parts of
  3796. the song.  For example:
  3797.  
  3798. Preset 1     All tracks
  3799. Preset 2     Only the chords (tracks 3 - 5)
  3800. Preset 3     Only the bass line (track 2)
  3801. Preset 4     The chords and the bass line (tracks 2 - 5)
  3802. Preset 5     Only the melody line (e.g. track 6)
  3803.  
  3804.  
  3805. Signatures
  3806. ----------
  3807.  
  3808. You  may  set  the key signature of the song using the Key Signature window,
  3809. opened  using  the  appropriate menu item.  It contains a slider setting the
  3810. number  of  accidentals  -  sharps  or flats - required (0 - 6), and a radio
  3811. button  selecting  whether  the  accidentals  should  be sharps (default) or
  3812. flats.
  3813.  
  3814. A reminder of the number of accidentals used in different keys:
  3815.  
  3816.  Number of   |        Sharps         |         Flats
  3817.  accidentals | Major key | Minor key | Major key | Minor key
  3818. -------------+-----------+-----------+-----------+-----------
  3819.       0      |     C     |     A     |     C     |     A
  3820.       1      |     G     |     E     |     F     |     D
  3821.       2      |     D     |     B     |     Bb    |     G
  3822.       3      |     A     |     F#    |     Eb    |     C
  3823.       4      |     E     |     C#    |     Ab    |     F
  3824.       5      |     B     |     G#    |     Db    |     Bb
  3825.       6      |     F#    |     D#    |     Gb    |     Eb
  3826.  
  3827. The  time  signature  is  set to 3/4 or 4/4 by using the Time Signature menu
  3828. item.  3/4 is three quarter note beats per measure, 4/4 is four quarter note
  3829. beats per measure.
  3830.  
  3831. Instrument settings
  3832. -------------------
  3833.  
  3834. Two  options  relating to the current instrument can be found in the Instr. 
  3835. Notation window, activated using the Current Instrument menu item.
  3836.  
  3837. The  Tranpose  slider is the display transposition value (-24 to 24) for the
  3838. current instrument.  This can be used, for example, to shift the main melody
  3839. one  octave  up to separate it from the bass line on the display (its actual
  3840. pitch  is  not  affected).    Usually you'll want to use steps of one octave
  3841. (i.e.  -24, -12, 12, 24), but any value can be chosen.  Note that the editor
  3842. can  display  just over four octaves (C-1 to D#-4), whereas OctaMED supports
  3843. 10.5 octaves.
  3844.  
  3845. If  the  Hide Instrument check box is selected, the current instrument won't
  3846. be  displayed  in  the notation editor (although its notes are played).  For
  3847. example,  if  notes  of a chord extend into the drum track, you can hide the
  3848. drum instrument(s), showing only the chords.
  3849.  
  3850. Also  relating  to  instruments, if the Show Instrument Numbers menu item is
  3851. selected,  instrument  numbers  will  be  displayed  above  the notes on the
  3852. selected track.
  3853.  
  3854. Entering notes
  3855. --------------
  3856.  
  3857. After  making  sure editing is on (in the upper screen), you can enter notes
  3858. either  using  the  keyboard or with the mouse.  Before editing using either
  3859. method,  you need to select which track the note should be entered to, using
  3860. the  Select  track  gadgets.    Make sure the track you select exists in the
  3861. current  block,  or  you'll get a warning message: for example, don't select
  3862. track 6 in a 4-track block.
  3863.  
  3864. Edit  using  the  keyboard  in  the usual way, noting that the cursor is the
  3865. large blue block.
  3866.  
  3867. To  edit  with the mouse, you must first select its length.  This is done by
  3868. clicking  on  one  of the diagrams of notes or rests at the very left of the
  3869. Notation  Control  window.  The length of the note in multiples of sixteenth
  3870. notes  is  shown  in  the  Length  display box (this also corresponds to the
  3871. number of lines in the Tracker editor).
  3872.  
  3873. Next  you  position  the mouse pointer (which now resembles the chosen note)
  3874. over  the point on the stave where you wish to place the note, and press the
  3875. left  mouse button.  If you hold down the mouse button and move the mouse up
  3876. and  down, you can hear the note corresponding to its position on the stave,
  3877. and this note is shown in the Note display box.
  3878.  
  3879. The  cycle  gadget  below the two display boxes sets which entering mode you
  3880. require  when  using  the mouse to edit.  Replace (the default) replaces the
  3881. notes  -  a  bit  like the Overwrite option found in wordprocessors.  Insert
  3882. inserts the notes, pushing the following notes to the right.  Delete deletes
  3883. the notes you click on, moving the following notes to the left.
  3884.  
  3885.  
  3886. The Upper Screen
  3887.  
  3888. This  part  of the main screen, above the Tracker editor or notation editor,
  3889. contains some important general functions and displays.
  3890.  
  3891. The  upper  screen  is  laid  out  in five rows, which contain the following
  3892. functions and status displays:
  3893.  
  3894. The first row
  3895. -------------
  3896.  
  3897. Play Song
  3898. This  gadget  plays  the  current  song  from the start of the first playing
  3899. sequence.
  3900.  
  3901.         [ Keyboard shortcut: Shift-Alt-Space ]
  3902.  
  3903. Cont Song
  3904. Plays  the current song from the current playing sequence position, starting
  3905. at  the  current line (or the first line if the gadget is clicked with Shift
  3906. held).
  3907.  
  3908.         [ Keyboard shortcut: Shift-Space ]
  3909.  
  3910. The remaining gadgets on this line have to do with instruments.
  3911.  
  3912. The  display  box  to  the  right of "Cont Song" contains the current sample
  3913. number,  and is followed by a gadget which opens the Instrument Load Window.
  3914.  
  3915. To the right of this gadget is a GetFile gadget which opens a file requester
  3916. to load one or more instruments (see Instr Menu/Load Instrument(s) ).  After
  3917. this  is a text gadget containing the name of the current instrument.  A new
  3918. instrument  may  also  be  loaded into the current slot by typing a new name
  3919. into this gadget.
  3920.  
  3921. If  there's no instrument in this position, the text box will be blank.  You
  3922. may  sometimes  run  across  a  song from which the composer has removed the
  3923. instrument  names  from  the text box, though still using the instruments in
  3924. the  song.    To  determine  whether  this is the case, make each instrument
  3925. number  current and see if it plays from the keyboard.  There's no advantage
  3926. in removing the instruments' names.
  3927.  
  3928. The  display box after this displays the size of the sample, or "-Synth-" if it is
  3929. a synthsound or "-------" if the slot is empty.  The size is prefixed by an "H" if
  3930. the sample is a hybrid sound.  The last gadget on this line opens the Type window,
  3931. with which you may select the type that the current instrument is to be.
  3932.  
  3933. The second row
  3934. --------------
  3935.  
  3936. Play Block
  3937. Plays  the  current block from the first line.  It will be replayed when the
  3938. last line is reached.
  3939.  
  3940.            [ Keyboard shortcut: Amiga-Space ]
  3941.  
  3942. Cont Block
  3943. Plays the current block from the current line.
  3944.  
  3945.            [ Keyboard shortcut: Alt-Space ]
  3946.  
  3947. The  display  box  contains  the channel mode of the current song, an "M" if
  3948. MIDI is active, and an "I" if MIDI Input is active (see MIDI Menu).
  3949.  
  3950. The remaining gadgets open certain instrument windows:
  3951.  
  3952. Instr Params
  3953. Opens  the  Instrument  Parameters  window, which allows you to edit various
  3954. instrument parameters.
  3955.  
  3956. Edit Sample
  3957. Opens the Sample Editor window.
  3958.  
  3959. Edit SynthS
  3960. Opens the Synthetic Sound Editor window.
  3961.  
  3962. The third row
  3963. -------------
  3964.  
  3965. D
  3966. Continues  the  block from the current line when a note is entered.  Editing
  3967. must be on.  The display box in the lower screen changes to "Waiting Input".
  3968.  
  3969. STOP
  3970. Stops  playing  the  song  /  block.  Sometimes notes will continue to sound
  3971. after  you  stop  the  cong.    Click STOP again, or press the space bar, to
  3972. silence them.
  3973.  
  3974. Shift-clicking  STOP (clicking it with Shift held) stops playing and inserts
  3975. command FFE at the cursor.  (See Commands A - F).
  3976.  
  3977.         [ Keyboard shortcut: Space bar ]
  3978.  
  3979. The  next gadget, four digits with a ":" between them, is the timer gadget. 
  3980. This  is  the  number  of minutes and seconds since Play Song/Block has last
  3981. been  clicked.    Clicking  STOP, Cont Song or Cont Block doesn't affect the
  3982. elapsed  time.    You  may  reset  the  timer (to 00:00) by clicking the "R"
  3983. gadget.
  3984.  
  3985.  The  timer gadget also remembers the current song position.  When you click
  3986. the  R  gadget,  the  current  line / playseq position / section position is
  3987. stored.  Clicking the timer gadget itself moves back to the stored position.
  3988.  
  3989. The  remainder  of this row contains the tempo gadgets, that are used to set
  3990. the  playing  speed.  The first cycle gadget cycles BPM, which allows you to
  3991. set the tempo in Beats Per Minute, and SPD (default), with which you may set
  3992. the tempo in the usual way.
  3993.  
  3994. To  understand  this completely, technical aspects need to be known.  Timing
  3995. is  handled  using  the  CIAB  timers,  which give out "timing pulses" which
  3996. trigger  OctaMED's  player  interrupt.    On  each  timing pulse effects are
  3997. handled  (see  Player  Commands), but a new note is usually not played every
  3998. pulse.
  3999.  
  4000. In  SPD  mode,  the  time  between pulses can be changed using the left-hand
  4001. slider.  This is called the "primary tempo".  Usually notes are played every
  4002. 6th  pulse,  but this also can be changed using the right-hand slider (it is
  4003. called  the "secondary tempo").  For example, if a new note was played every
  4004. 3rd  pulse,  the  playing speed would be twice as fast.  This doesn't affect
  4005. the speed of effects.
  4006.  
  4007. Graphically:
  4008.  
  4009. pulse   \         PLAY NOTE  \
  4010.          the time between pulses is the "primary tempo"
  4011. pulse   /         DO EFFECTS   \
  4012.                                 \
  4013. pulse             DO EFFECTS     \ The number of pulses between notes
  4014.                                  / (4 in this example) is the "secondary
  4015. pulse             DO EFFECTS    /  tempo"
  4016.                                /
  4017. pulse             PLAY NOTE   /
  4018.  
  4019. The  primary  tempo  can  be 1 - 240.  The higher the number, the faster the
  4020. speed,  and the default is 33.  For 4-channel or MIDI songs, values 11 - 240
  4021. should  be  used  (1  -  10 can also be used, but they only exist for Sound/
  4022. Noise/Protracker  compatibility).    For  5 - 8-channel songs, values 1 - 10
  4023. should be used; 11 - 240 are equivalent to 10 (to techies: this works in 5 -
  4024. 8-channel  mode  not by changing the time between pulses but by changing the
  4025. size of the mix buffer).
  4026.  
  4027. The  secondary  tempo  can be $01 - $20 (in HEXADECIMAL, i.e.  33 values are
  4028. possible),  and  the  default  is  6.  The lower, the faster.  This allows a
  4029. fairly  rough  tempo  setting  (it's  the  way  the other Trackers set their
  4030. tempos).    For  MIDI use (especially for synchronization), you should leave
  4031. this  at  6  and  adjust the primary tempo instead.  Note that the secondary
  4032. tempo doesn't affect the speed of effects, unlike the primary tempo.
  4033.  
  4034. In  BPM  mode, the first slider controls the number of beats per minute (for
  4035. example,  60 is one beat per second).  The second slider controls the number
  4036. of  lines  per  beat (for example, 8 means eight lines are considered as one
  4037. beat).    Make  sure that the secondary tempo in SPD mode is set to 6 before
  4038. using  BPM; otherwise, the timing won't be accurate.  (This may, in fact, be
  4039. useful  to  some  users.  For example, double the normal BPM accuracy can be
  4040. obtained by setting the secondary tempo to 3).
  4041.  
  4042.    [ Keyboard shortcuts:  Ctrl- - (minus)     Decrease primary tempo
  4043.                           Ctrl- + (plus)      Increase primary tempo
  4044.                           Shift-Ctrl- -       Decrease secondary tempo
  4045.                           Shift-Ctrl- +       Increase secondary tempo ]
  4046.  
  4047. The  cycle gadget on the far right of the row plays at normal speed when NRM
  4048. (default),  two-thirds  speed when at 2/3, and half-speed when at 1/2.  This
  4049. is  useful for editing while the song is playing: you can slow the song down
  4050. without changing the tempo values, to make entering notes easier.
  4051.  
  4052. NOTE: It's possible to make a song which takes up all of the processor time.
  4053. It  will  therefore  be  impossible  to  stop  it.     This shouldn't happen
  4054. accidentally, but it can be done, for example, by filling a block with notes
  4055. and  setting  the  primary  tempo to 240 and the secondary tempo to 1...  To
  4056. stop playing, hold both mouse buttons down for about five or six seconds.
  4057.  
  4058. The fourth row
  4059. --------------
  4060.  
  4061. This row contains many status displays and the octave cycle gadget.
  4062.  
  4063. The  "Sg"  gadget  opens  the  Song  Selector window, and the status display
  4064. immediately  to  its  right displays the current song and the last song in a
  4065. multi-module.    (A  multi-module  is  a project consisting of more than one
  4066. song, but which all share the same set of instruments).
  4067.  
  4068. The  arrow gadgets are used to decrease / increase the current song number. 
  4069. If the current song is the last song, and the right arrow gadget is clicked,
  4070. an "Add new song?" requester appears, and OctaMED will add a new song to the
  4071. project  if  you  click "Add".  Shift-clicking the right arrow gadget adds a
  4072. new  song  without the requester.  Shift-clicking the left arrow deletes the
  4073. last  song  in memory after displaying a requester.  (Equivalent to the "Add
  4074. New" and "Delete Last" items in the Song menu).
  4075.  
  4076. The  "Sc"  gadget  opens  the Section List window, and the following display
  4077. shows  the  current section list position and the total number of entries in
  4078. the section list.
  4079.  
  4080. The "Sq" gadget opens the Playing Sequence window, and the following display
  4081. shows  the current playing sequence position and the total number of entries
  4082. in the playing sequence.
  4083.  
  4084.  Clicking the "B" gadget opens the Block List window, and shift- clicking it
  4085. opens  the Block Properties window.  The following display shows the current
  4086. block  number  (starting  at  000),  the  number  of the last block, and the
  4087. current block name.  The last block number + 1 is the total number of blocks
  4088. in the song (since the numbering starts at 000).
  4089.  
  4090. The octave gadget shows which octaves are currently in use when you play the
  4091. Amiga's  keyboard  (see  the Tracker Editor).  The first digit is the octave
  4092. number  of  the  lower row of keys, the second is that of the upper row.  If
  4093. the  current instrument has a MIDI channel of 0, keys F1 - F5 select octaves
  4094. 1+2, 2+3, 3+4, 4+5, and 5+6.  If its MIDI channel isn't zero, F2 - F4 select
  4095. 4+5 to 6+7, F1 toggles 1+2 to 3+4, and F5 toggles 7+8 to 9+A.  To clarify:
  4096.  
  4097.    Function key | Octave selected (non-MIDI) | Octave selected (MIDI)
  4098.    -------------+----------------------------+-----------------------
  4099.         F1      |            1+2             |    3+4 / 2+3 / 1+2
  4100.         F2      |            2+3             |          4+5
  4101.         F3      |            3+4             |          5+6
  4102.         F4      |            4+5             |          6+7
  4103.         F5      |            5+6             |    7+8 / 8+9 / 9+A
  4104.  
  4105.  
  4106. The fifth row
  4107. -------------
  4108.  
  4109. This  row  contains  three  important  check  boxes  and the track selection
  4110. gadgets.
  4111.  
  4112. Edit
  4113. Toggles  editing  on/off.   With editing on, you may insert notes or numbers
  4114. into the song (see the Tracker Editor).
  4115.  
  4116.      [ Keyboard shortcut: Esc ]
  4117.  
  4118. Space
  4119. With  this  switch  on,  a  set  number  of lines are skipped when a note is
  4120. entered  into  the  song.    (The number of lines skipped, and other spacing
  4121. options, are set in the Keyboard Options window).   Useful for entering slow
  4122. pieces of music, since you don't have to press the Del key as often.
  4123.  
  4124. When  you  enter  notes  during  playing (in "real-time") with Space on, the
  4125. notes  will be quantized.  For example, with a spacing value of 2, the notes
  4126. will  only  be  placed on even-numbered lines (if Auto- Round Spacing is on,
  4127. see Keyboard Options).
  4128.  
  4129. When  shift-clicked,  spacing is switched on and the Keyboard Options window
  4130. is opened (with a view to editing the spacing options).
  4131.  
  4132.      [ Keyboard shortcut: ~ (the key just below Esc) ]
  4133.  
  4134. Chord
  4135. When on, the chord entering mode is active.  You must still know which notes
  4136. of  a  chord  you want to use, but OctaMED will place them on the tracks for
  4137. you.
  4138.  
  4139. First  you  should select the tracks which the chord entering affects (using
  4140. the  Select  track  gadgets documented below).  The chord always starts from
  4141. the  current  track  and  continues  to the following selected tracks on the
  4142. right.
  4143.  
  4144. Now,  holding keys down will enter a chord.  For example, to enter a C major
  4145. chord:  hold  down  the Q key, press the E key and keep both keys held down,
  4146. then  press  the G key.  On releasing the keys, the cursor moves back to the
  4147. initial  track (if Chord Reset in the Keyboard Options window is on).  Chord
  4148. entering also works well using a MIDI keyboard (see the MIDI Menu).
  4149.  
  4150. (Chords may be deleted using Left Amiga-DEL: see Edit Shortcuts).
  4151.  
  4152.      [ Keyboard shortcut: Shift-Esc ]
  4153.  
  4154. The  remaining  gadgets  are  the track selection gadgets.  The row of small
  4155. gadgets toggle the tracks on/off.  The cycle gadget toggles On/Off (default)
  4156. and  Select.   On/Off mode allows you to mute some tracks while listening to
  4157. others  by clicking the track selection gadgets.  This is often useful while
  4158. editing.  (You can also use the numeric keypad for this, see Keyboard Opts).
  4159. Select  is  used in many editing functions (including Chord, Edit Menu/Paste
  4160. to Sel Tracks, and Transpose).
  4161.  
  4162. Shift-clicking  a track selection gadget "solos" the track, i.e.  clears all
  4163. tracks apart from the one selected.
  4164.  
  4165. The  arrow  gadgets display the previous / next fourteen tracks in the small
  4166. gadgets.    Shift-clicking  the  arrow  gadgets  displays  the  first / last
  4167. fourteen  tracks  in  the  current block.  The "Set" and "Clr" gadgets set /
  4168. clear all tracks.
  4169.  
  4170.  
  4171. The Lower Screen
  4172.  
  4173. This  part  of the main screen, below the Tracker editor or notation editor,
  4174. contains a few display boxes and one gadget.
  4175.  
  4176. On  the  left-hand  side  is  a display box showing the free memory.  "Chip"
  4177. memory  is  the memory used to store graphics and samples, and "Fast" memory
  4178. stores  everything  else.  So if you have a song with many samples in it, it
  4179. will probably be the Chip memory status you'll be watching.  A more detailed
  4180. account of the free memory can be obtained on the title bar by pressing Ctrl
  4181. - F.
  4182.  
  4183. The  smaller display box in the middle of the screen shows the status of the
  4184. song's  playing  ("Playing  Song",  "Playing  Block", or "Stopped"), and the
  4185. current  disk activity ("Loading", "Saving").  It also shows "Waiting Input"
  4186. if the D button (beside STOP) is clicked.
  4187.  
  4188. When on, the "Freeze Display" check box turns off parts of the display.  The
  4189. Tracker  editor  is  removed and replaced with "Frozen", and the two sets of
  4190. equalizers  are  disabled.   This releases more processor time, advantageous
  4191. when  multitasking.  The screen is automatically frozen when it isn't at the
  4192. front if Settings menu/Auto-Freeze Screen is on.
  4193.  
  4194. The  four  larger  boxes  at  the bottom of the display showing the waveform
  4195. currently being output by each of the Amiga®'s sound channels.  The displays
  4196. take up quite a lot of processor time when using a standard 68000 processor,
  4197. so  they  may be turned off in the Settings menu.  When enabled, the line in
  4198. the center of them is blue: when disabled, it is white.
  4199.  
  4200.  
  4201. Player Commands
  4202.  
  4203. Player  commands  provide  a  way  of  composing  music   that   sounds more
  4204. interesting.    They  consist  of  numbers  that are attached to a note, and
  4205. generally  they  perform  effects  on  the  notes  they are attached to (for
  4206. example,  pitch  /  volume  sliding  etc.).    Some commands control various
  4207. functions not directly applicable to notes: for example, changing the song's
  4208. tempo, jumping to a new playing sequence entry, or sending a MIDI message to
  4209. a MIDI device.
  4210.  
  4211. The  data  byte  allows  you to control the command's intensity, depth etc. 
  4212. Both the command number and data byte are in HEXADECIMAL !!!
  4213.  
  4214. They  are  entered in the command digits using the Tracker editor, by simply
  4215. positioning  the  cursor  on the digit and typing a new number (with editing
  4216. on).  In addition, the left command digit can be set to 1 by positioning the
  4217. cursor over the right command digit, holding down Right Alt and pressing the
  4218. right command digit's value.  For example, Alt-9 inserts command 19.
  4219.  
  4220.                 C - 2  A 1 2 3 4
  4221.                          \ | \ |
  4222.                      command  \|
  4223.                                data byte
  4224.  
  4225. Advance  Cursor  Right  is often a help in editing the command digits.  (See
  4226. the Keyboard Options Window).
  4227.  
  4228. You'll  notice  that  some  commands  are  indicated   as   being ProTracker
  4229. compatible.    When loading and saving ProTracker modules, OctaMED makes any
  4230. necessary command conversions automatically.
  4231.  
  4232. The player commands can be split into four groups:
  4233.  
  4234.          Commands  0  - 9  (These topics contain descriptions of each
  4235.          Commands  A  - F   player command)
  4236.          Commands 11 - 1F 
  4237.           MIDI Commands   
  4238.  
  4239. Before  you read the descriptions, make sure you understand timing pulses (see the
  4240. Upper Screen) !!
  4241.  
  4242. Commands 0 - 9
  4243.  
  4244. Command 0:  ARPEGGIO                (MIDI: controller value)
  4245. ------------------------------------------------------------
  4246.  
  4247. This  command changes the pitch of the note quickly (once every timing pulse).  It
  4248. can  be  used  to create "chords" or special effects.  If you've listened to music
  4249. made with the Commodore 64, you MUST have heard arpeggios!
  4250.  
  4251. The pitch is changed between three different pitches during one note:
  4252.  
  4253.         Pitch 1:  The original note
  4254.         Pitch 2:  Pitch 1 + the first data byte digit halfsteps up
  4255.         Pitch 3:  Pitch 1 + the second data byte digit halfsteps up
  4256.  
  4257. Note:  Pitch 3 is played first, then pitch 2, pitch 1, pitch 3, pitch 2 etc.  (the
  4258. number of pitches for each note depends on the secondary tempo).
  4259.  
  4260. For example, to create a C major arpeggio:
  4261.  
  4262.         Pitch 1:  C-2   (for example)
  4263.         Pitch 2:  E-2 = 4 halfsteps higher than C-2
  4264.         Pitch 3:  G-2 = 7 halfsteps higher than C-2
  4265.  
  4266. This produces:  C-2 10047
  4267.                 --- 00047
  4268.                 --- 00047 and so on... Note that the data byte with a
  4269.                           blank note continues the arpeggio.
  4270.  
  4271. The data byte for a minor chord would be 37.
  4272.  
  4273. Arpeggios sound better with some instruments than others
  4274.  
  4275. (Note that this works differently with MIDI, see MIDI Commands)
  4276.  
  4277.  
  4278. Command 1:  SLIDE UP                (MIDI: pitchbender up)
  4279. ----------------------------------------------------------
  4280.  
  4281. This command slides up the pitch of the current track.
  4282.  
  4283. It  actually works by decreasing the period of the note the amount of the databyte
  4284. every  timing pulse.  Sounds rather technical??  Yes..  but a detailed description
  4285. is  not  really necessary, since slides can be made automatically: see Edit Menu /
  4286. Pitch Slide / Type 2.
  4287.  
  4288. If  you  use this function for special effects, experimentation is the key...  For
  4289. example:
  4290.      
  4291.      A-1 10000 --- 00000 --- 0010F <- slide up a bit
  4292.  
  4293.  
  4294. Command 2:  SLIDE DOWN              (MIDI: pitchbender down)
  4295. ------------------------------------------------------------
  4296.  
  4297. Same as command 1, except slides down.
  4298.  
  4299.  
  4300. Command 3:  PORTAMENTO              (MIDI: set pitchbender)
  4301. -----------------------------------------------------------
  4302.  
  4303. Another  slide  command, with which you can create perfect slides more easily than
  4304. with  commands  1  and 2.  The difference is that commands 1 and 2 replay the note
  4305. they slide to: command 3 doesn't replay the note.
  4306.  
  4307. The data byte is the slide speed.  An example is the easiest way to explain this:
  4308.  
  4309.     C-2 50000 <- Note C is played
  4310.     --- 00000
  4311.     E-2 50305 <- This note isn't played! Instead, the slide target is set
  4312.     --- 00300    to E-2 with a slide speed of 5
  4313.     --- 00300 <- When the speed is zero, the previous speed is used
  4314.     --- 00306 <- The speed may be changed during a slide
  4315.  
  4316. This example would slide from C-2 to E-2, but the slide stops EXACTLY when a pitch
  4317. of E-2 is attained (with commands 1 and 2 you can slide beyond the note).
  4318.  
  4319. Again, slides can be created automatically in Edit / Pitch Slide / Type 1.
  4320.  
  4321. Command 4:  VIBRATO                 (MIDI: modulation wheel)
  4322. ------------------------------------------------------------
  4323.  
  4324. Rapidly  increases  and  decreases  the note's pitch.  The first digit of the data
  4325. byte  is  the  vibrato speed, the second is the vibrato depth.  If either digit is
  4326. zero, the previous speed and/or depth is used.
  4327.  
  4328. The  higher  the digit's value, the greater the speed / depth.  (Remember that the
  4329. digits  are  in hexadecimal: values 0 - 9 and A - F can be used, giving a total of
  4330. 16 possible values for each digit).
  4331.  
  4332.  
  4333. Command 5:  SLIDE AND FADE          (MIDI: controller number)
  4334. -------------------------------------------------------------
  4335.  
  4336. ProTracker-compatible.
  4337.  
  4338. This command combines commands 300 and Dxx.  The slide speed is the previous speed
  4339. entered with command 3, and the fade speed is the data byte.
  4340.  
  4341.     C-1 10000
  4342.     D-3 10303 <- slide at speed 3
  4343.     --- 00300 <- continue sliding
  4344.     --- 00502 <- continue sliding and fade at speed 2 (see command D later)
  4345.     --- 00502
  4346.  
  4347.  
  4348. Command 6:  VIBRATO AND FADE   [ ProTracker-compatible ]
  4349. --------------------------------------------------------
  4350.  
  4351. Combines  commands  400  and  Dxx.  Again, the vibrato speed is the previous speed
  4352. entered with command 4, and the fade speed is the data byte.
  4353.  
  4354. Command 7:  TREMOLO   [ ProTracker-compatible ]
  4355. ----------------------------------------------
  4356.  
  4357. This  command  is  a  kind  of "volume vibrato".  The first data byte digit is the
  4358. tremolo  speed,  the second is the depth.  The depth must be quite high before the
  4359. effect is audible (try A - F).
  4360.  
  4361. The higher the digit's value, the greater the speed / depth.
  4362.  
  4363.  
  4364. Command 8:  SET HOLD/DECAY          (MIDI: set hold only)
  4365. ---------------------------------------------------------
  4366.  
  4367. This  command  must  be  located on the same line as a note.  The command sets the
  4368. hold and decay values for the note (see Instrument Parameters).
  4369.  
  4370. The first digit is the decay value, the second is the hold value.
  4371.  
  4372.     C-3 30824  (decay = 2, hold = 4)
  4373.     -|- 30000
  4374.     -|- 30000
  4375.     --- 00000
  4376.  
  4377.  
  4378. Command 9:  SECONDARY TEMPO         (MIDI: no action)
  4379. -----------------------------------------------------
  4380.  
  4381. Sets  the  secondary  tempo (the number of timing pulses per note).  The data byte
  4382. must be $01 - $20.
  4383.  
  4384. (See also Player Commands, A - F, 11 - 1F, and MIDI Commands)
  4385.  
  4386.  
  4387. Commands A - F
  4388.  
  4389. Command A:  VOLUME SLIDE            (MIDI: polyphonic aftertouch)
  4390. ----------------------------------------------------------------
  4391.  
  4392. This  is exactly the same as command D, for Sound/Noise/Protracker compatibility. 
  4393. However, please use D instead of this.
  4394.  
  4395. Command B:  PLAYING SEQUENCE POSITION JUMP
  4396. ------------------------------------------
  4397.  
  4398. Allows  you  to  make  songs that have a beginning, which is played only once, and
  4399. another  part,  which  is repeated continuously.  The command causes a jump to the
  4400. playing  sequence  number  given  by the data byte.  If the data byte is zero, the
  4401. song is played from the first playseq entry.
  4402.  
  4403. Note  that  when more than one playing sequence is defined, the specified entry in
  4404. the  CURRENT playing sequence is jumped to.  At present, no command exists to jump
  4405. to an entry in the section list.
  4406.  
  4407. Example:    --- 00B02 <- start playing from playseq number 003
  4408.  
  4409.  
  4410. Command C:  SET VOLUME
  4411. ----------------------
  4412.  
  4413. You can override the default volume of the instrument with this important command.
  4414.  
  4415. For example, "A-3 40C20" is played with volume 20.
  4416.  
  4417. There  are 65 volume levels (0 - 64), 0 = silent, 64 = maximum.  The data byte may
  4418. be either 00 - 64 or $00 - $40 (decimal or hex: see Song Options.
  4419.  
  4420. It is also possible to change the volume of an already played note:
  4421.  
  4422.     A-3 40000
  4423.     --- 00000
  4424.     --- 00C10 <- change volume to 10
  4425.  
  4426. In  addition,  you may actually set the default instrument volume.  The value MUST
  4427. be  in HEX!, and is between 80 and C0.  80 = volume $0, C0 = volume $40 (hex).  In
  4428. other words, add 80 to the normal volume in hex.
  4429.  
  4430. Note  that setting default instrument volumes can cause trouble in multi- modules,
  4431. since  all the songs share the same set of instruments.  So it is recommended that
  4432. default instrument volumes are only changed in non-multi- modules.
  4433.  
  4434. Command D:  VOLUME SLIDE            (MIDI: channel pressure)
  4435. ------------------------------------------------------------
  4436.  
  4437. You  can  increase  /  decrease volume smoothly with this command.  The first data
  4438. byte digit is the amount of volume increase ("crescendo"), the second digit is the
  4439. amount  of  decrease  ("decrescendo").    If  crescendo  is  zero,  decrescendo is
  4440. performed:  otherwise,  only  crescendo is performed regardless of the decrescendo
  4441. value.
  4442.  
  4443.     C-2 30C40
  4444.     --- 00D01 <- a bit quieter
  4445.     --- 00D01 <- even quieter
  4446.     --- 00D20 <- and crescendo back to original volume
  4447.  
  4448. In  this  command  the  volume is changed every timing pulse.  So if the secondary
  4449. tempo was 6, a decrescendo value of 1 would decrease the volume by 6.  The example
  4450. above would look like this using C commands (except it doesn't sound as smooth):
  4451.  
  4452.     C-2 40C40 (volumes are decimal in this example)
  4453.     --- 00C34 <- -6
  4454.     --- 00C28 <- -6
  4455.     --- 00C40 <- +12
  4456.  
  4457.  
  4458. Command E:  SYNTH JUMP              (MIDI: pan control)
  4459. -------------------------------------------------------
  4460.  
  4461. This  command  only applies to synth/hybrid (and MIDI) instruments.  It is used to
  4462. trigger  a  jump  in the waveform sequence.  The data byte is the jump destination
  4463. (line number).
  4464.  
  4465.     C-4 40000 <- should be a synth/hybrid instrument
  4466.     --- 00000
  4467.     --- 00E05 <- causes a jump to line #5  (see Synthsound Programming)
  4468.  
  4469.  
  4470. Command F:  PRIMARY TEMPO / MISCELLANEOUS
  4471. -----------------------------------------
  4472.  
  4473. Command F has many different actions depending on the data byte.
  4474.  
  4475. If  the  data  byte  is  00,  it causes an immediate jump to the next entry in the
  4476. playing  sequence  (or  the  beginning  of  the  block if you are only playing the
  4477. current block).  This function is better to implement by making the block shorter,
  4478. as it takes less memory, so it mainly exists for Tracker compatibility.
  4479.  
  4480.     C-2 40F00 <- this is the last note that will play in the current block
  4481.  
  4482. When  the  data byte is $01 - $F0, the command changes the primary tempo (the time
  4483. between timing pulses).
  4484.  
  4485. If  the  new  tempo is 01 - 0A, it is compatible with Trackers, but you should use
  4486. command  9  instead  of this command as it's directly Tracker-compatible (but make
  4487. sure the primary tempo is set to the default 33).
  4488.  
  4489.     E-3 60FF0 <- quickest tempo (240 decimal)
  4490.     --- 00000
  4491.     --- 00F0B <- slowest (11 decimal)
  4492.  
  4493. Data bytes FF1 - FFF are reserved for special actions, most of which are currently
  4494. in use:
  4495.  
  4496. FF1  causes  the same note to be actually played twice.  In this way it's possible
  4497. to  create  fast rhythms.  It's identical to command 1F03.  With a secondary tempo
  4498. of 6:
  4499.  
  4500.         C-3 20FF1 is the same as C-3 20000
  4501.                                  C-3 20000 with double tempo (i.e. 3)
  4502.  
  4503. FF2  plays  the  same  note  only  once,  but it is not started immediately.  It's
  4504. identical to command 1F30.  Again with a secondary tempo of 6:
  4505.  
  4506.         C-3 20FF2 is the same as --- 00000
  4507.                                  C-3 20000 with double tempo
  4508.  
  4509. FF3  works  like  FF1  except  the  note is played three times (very quick).  It's
  4510. identical to command 1F02.  Again with a secondary tempo of 6:
  4511.  
  4512.         C-3 20FF3 is the same as C-3 20000
  4513.                                  C-3 20000
  4514.                                  C-3 20000 with triple tempo (i.e. 2)
  4515.  
  4516. FF4 delays the note one-third of a line.
  4517.  
  4518. FF5  delays  the note two-thirds of a line.  FF4 and FF5 can be used, for example,
  4519. to create triplets:
  4520.  
  4521.         C-2 10000  Here, the three notes will be evenly spaced throughout
  4522.         D-2 10FF4  the four lines (they'll have a length of one-and-a-third
  4523.         E-2 10FF5  lines each)
  4524.         --- 00000
  4525.  
  4526.     They only work accurately when the secondary tempo is divisible by 3
  4527.     (3, 6, 9 etc.).
  4528.  
  4529. FF8 turns the low-pass filter off (see the Song Options Window)
  4530.  
  4531. FF9 turns the low-pass filter on
  4532.  
  4533. FFD  (doesn't  work  with  MIDI)  causes the pitch of the channel to be set to the
  4534. pitch of the new note, but the new note is not replayed.
  4535.  
  4536.         C-1 20000 <- play note
  4537.         --- 00000
  4538.         C-2 20FFD <- don't replay the note, just set the pitch to C-2
  4539.  
  4540. This is especially useful in playing long samples or samples with a loop set (like
  4541. strings, choirs etc.), as the undesirable "click" that you can sometimes hear when
  4542. playing a new note is eliminated.
  4543.  
  4544. FFE stops playing immediately.  (When used in 5 - 8-channel mode, the song's notes
  4545. are  also  stopped).    If you want to make a song which only plays once, put this
  4546. command at the end of the song.  It can be easily inserted by clicking STOP with a
  4547. Shift key held.
  4548.  
  4549. FFF  stops the note on the current track.  Is almost like C00 with Amiga® samples,
  4550. but  while  C00  sets  the  volume  of  the  note  to zero, FFF turns the note off
  4551. completely (there is a subtle difference :).
  4552.  
  4553. (See also Player Commands  0 - 9, 11 - 1F, and MIDI Commands)
  4554.  
  4555. Commands 11 - 1F
  4556.  
  4557. Command 11:  SLIDE PITCH UP ONCE   [ Equivalent to ProTracker command E1 ]
  4558. --------------------------------------------------------------------------
  4559.  
  4560. Whereas command 1 slides the pitch smoothly, this command only changes it once per
  4561. note (for greater accuracy).
  4562.  
  4563.     C-2 31105 <- slightly above C-2
  4564.  
  4565. To  techies: with this command, you may play a note at any period value you wish. 
  4566. For example, C-2 is 428.  To play at period 431, simply enter "C-2 31103".
  4567.  
  4568. Command 12:  SLIDE PITCH DOWN ONCE   [ Equivalent to PT command E2 ]
  4569. --------------------------------------------------------------------
  4570.  
  4571. Equivalent to command 11, except slides down.
  4572.  
  4573. Command 14:  PT-COMPATIBLE VIBRATO   [ Equivalent to ProTracker command 4 ]
  4574. --------------------------------------------------------------------------
  4575.  
  4576. In  Protracker,  the  vibrato  command was changed from NoiseTracker.  The maximum
  4577. depth  was  halved  to give greater accuracy.  This command is compatible with the
  4578. new  Protracker  vibrato  (loading  Protracker  songs automatically changes the PT
  4579. vibrato command to this command 14).
  4580.  
  4581. Command 15:  SET FINETUNE
  4582. -------------------------
  4583.  
  4584. Overrides the default finetune value of the instrument.
  4585.  
  4586. Since these are hexadecimal numbers, negative numbers must be expressed as:
  4587.  
  4588.     -1 = FF        -3 = FD         -5 = FB          -7 = F9
  4589.     -2 = FE        -4 = FC         -6 = FA          -8 = F8
  4590.  
  4591.     C#3 21503 <- finetune = +3
  4592.     D-2 315F8 <- finetune = -8
  4593.  
  4594.  
  4595. Command 16: LOOP   [ Equivalent to ProTracker command E6 ]
  4596. ---------------------------------------------------------
  4597.  
  4598. This  interesting  command  enables  you  to construct a loop within a block.  For
  4599. example:
  4600.  
  4601.     ...
  4602.     004 C-3 11600 <- data byte = $00: mark loop beginning
  4603.     005 D#2 10000
  4604.     006 --- 11603 <- data byte = $03: loop three times
  4605.     ...
  4606.  
  4607. This  example would play lines 004 - 006 three times before continuing.  You can't
  4608. nest loops!
  4609.  
  4610. Command 18:  CUT NOTE               (MIDI: no action)
  4611. -----------------------------------------------------
  4612.  
  4613. Almost  like  hold  (command  8),  except  it  sets  the volume to zero instead of
  4614. actually  switching  the  note  off.  This is Protracker-compatible (equivalent to
  4615. command EC).
  4616.  
  4617. Command 19:  SAMPLE START OFFSET    (MIDI: no action)   [ PT command 9 ]
  4618. -----------------------------------------------------------------------
  4619.  
  4620. When playing a sample, this command sets the starting byte in steps of 256 bytes (
  4621. = $100 hex).  Useful for speech samples.
  4622.  
  4623.     C-2 11904 <- play the sample starting at byte $400 = 1024
  4624.  
  4625.  
  4626. Command 1A:  SLIDE VOLUME UP ONCE   (MIDI: no action)   [ PT command EA ]
  4627. -------------------------------------------------------------------------
  4628.  
  4629. Allows you to make slow volume slides, since the volume is slid only once per line
  4630. (on the first timing pulse of each line).
  4631.  
  4632.     D-2 11A01 <- a looped string, perhaps, default volume 0
  4633.     --- 01A01
  4634.     (and so on..)
  4635.  
  4636.  
  4637. Command 1B: SLIDE VOLUME DOWN ONCE  (MIDI: no action)   [ PT command EB ]
  4638. -------------------------------------------------------------------------
  4639.  
  4640. Equivalent to 1A except slides down.
  4641.  
  4642.  
  4643. Command 1D: JUMP TO NEXT PLAYSEQ ENTRY   [ Equivalent to PT command D ]
  4644. -----------------------------------------------------------------------
  4645.  
  4646. This command is like F00, except that you can specify the line number of the first
  4647. line to be played.  The line number is (as usual) given in HEX.
  4648.  
  4649.     --- 01D0A <- next playseq entry, start at line 10 (skip lines 000-009)
  4650.  
  4651.  
  4652. Command 1E: REPLAY LINE   [ Equivalent to ProTracker command EE ]
  4653. -----------------------------------------------------------------
  4654.  
  4655. Replays  the  commands in the current line the specified number of times.  Doesn't
  4656. replay the notes.
  4657.  
  4658.     C-2 10000 --- 00000
  4659.     --- 00101 --- 01E06 <- replay the commands in this line six times
  4660.  
  4661.  
  4662. Command 1F: NOTE DELAY AND RETRIGGER   [ PT commands EC and ED ]
  4663. ----------------------------------------------------------------
  4664.  
  4665. Gives  you  accurate control over note playing.  You can delay the note any number
  4666. of  timing  pulses, and initiate fast retrigger.  The first data byte digit is the
  4667. note delay value, the second one is the retrig value.
  4668.  
  4669.     C-2 11F20 <- delay 2 timing pulses
  4670.  
  4671.      => pulse  0  ---
  4672.                1  ---
  4673.                2  C-2
  4674.                3  ---
  4675.                ...
  4676.  
  4677.     C-2 11F02 <- retrig every second pulse
  4678.  
  4679.      => pulse  0  C-2
  4680.                1  ---
  4681.                2  C-2
  4682.                3  ---
  4683.                4  C-2
  4684.                ...
  4685.  
  4686.     C-2 1FF22 <- delay 2 pulses THEN retrig every second pulse
  4687.  
  4688.      => pulse  0  ---
  4689.                1  ---
  4690.                2  C-2
  4691.                3  ---
  4692.                4  C-2
  4693.                ...
  4694.  
  4695.     Command 0FF1 is equal to 1F03, 0FF2 to 1F30, and 0FF3 to 1F02.
  4696.  
  4697. (See also Player Commands, 0 - 9, A - F, and MIDI Commands)
  4698.  
  4699.  
  4700. MIDI Commands
  4701. -------------
  4702.  
  4703. Please  read  the  other command explanations (see Player Commands) before reading
  4704. this.   This topic is like an "erratum" for MIDI, in that it documents the changes
  4705. to the other command documentation required for MIDI use.
  4706.  
  4707. Commands  B,  F,  16,  1D,  1E,  and  1F  all work identically with MIDI to Amiga®
  4708. instruments.   Commands 15, 18, 19, 1A, and 1B have no effect when used with MIDI.
  4709.  
  4710. If  you  are  unfamiliar  with any of the terms used in this topic, please consult
  4711. your MIDI device's manual.
  4712.  
  4713. Command 0:  CONTROLLER VALUE
  4714. ----------------------------
  4715.  
  4716. See command 5 for a description.
  4717.  
  4718. Command 1:  PITCHBENDER UP
  4719. --------------------------
  4720.  
  4721. This  command "turns" the pitchbender 8 × data byte steps up on each timing pulse.
  4722. However,  automatic  slide making (unfortunately) can't be used here.  Because the
  4723. actual  range  of the pitchbender is different for different instruments, you must
  4724. find the right value by experimenting.
  4725.  
  4726. When  a  new note is played, the pitchbender is not reset automatically.  To reset
  4727. it, use this command with a data byte of 00.
  4728.  
  4729.     G-2 L01FF <- turn pitchbender up very quickly
  4730.     --- 00000
  4731.     --- 00100 <- then reset the pitchbender
  4732.  
  4733.  
  4734. Command 2:  PITCHBENDER DOWN
  4735. ----------------------------
  4736.  
  4737. As command 1, except turns the pitchbender down.
  4738.  
  4739. Command 3:  SET PITCHBENDER
  4740. ---------------------------
  4741.  
  4742. With  this  command  you  may  set  the  pitchbender to an exact value, instead of
  4743. sliding as in commands 1 and 2.  The data byte is the pitchbender value, expressed
  4744. as a signed hexadecimal digit (aargh!!  ;-)
  4745.  
  4746.         $00       = center position
  4747.         $80 (-7F) = smallest value
  4748.         $7F       = largest value
  4749.  
  4750.     C-2 30000
  4751.     --- 0037F <- pitchbender to maximum value
  4752.     --- 00300 <- reset
  4753.  
  4754.  
  4755. Command 4:  MODULATION WHEEL
  4756. ----------------------------
  4757.  
  4758. Affects  the  modulation  wheel of the current channel.  The data byte can be 00 -
  4759. 7F:  00  =  no  modulation,  7F = maximum.  Values 80 - FF are reserved for future
  4760. expansion (i.e.  won't work ;).  (Modulation is usually vibrato).
  4761.  
  4762. Command 5:  CONTROLLER NUMBER
  4763. -----------------------------
  4764.  
  4765. This  command,  in  conjunction  with  command  0,  allows  you to change any MIDI
  4766. controller (command $Bx cc vv, where cc = controller number, vv = value).
  4767.  
  4768. First  you  set  the  number  of the controller you wish to change with command 5.
  4769. Then  you  can select the value with command 0.  Subsequent uses of command 0 will
  4770. affect  the  controller  previously  set  with command 5.  Remember that each MIDI
  4771. channel has its own controller number.
  4772.  
  4773. If  you  need  to use a controller value of $00, you can't use "00" as a data byte
  4774. because  command  "0000"  means  "do  nothing".    Instead,  you need to use "80".
  4775. Acceptable controller numbers and values are $00 - $7F.
  4776.  
  4777. For example (assuming instrument 3 is set to MIDI channel 1):
  4778.  
  4779.     C-2 30000
  4780.     --- 00507 <- controller $07 = volume, according to the MIDI standard
  4781.     D-2 3007F <- set max. volume (7F), command $B0 $07 $7F is sent
  4782.     --- 00000
  4783.     F-3 30001 <- small volume ($01)
  4784.     --- 0055C <- select controller $5C (tremolo depth)
  4785.     G-4 30080 <- set to 0 (note: $80 = $00)
  4786.  
  4787.  
  4788. Command 8:  SET HOLD ONLY
  4789. -------------------------
  4790.  
  4791. Just  to  underline  that  decay  can't  be  used with MIDI instruments.  (This is
  4792. because with MIDI, the volume of an already played note can't be altered).
  4793.  
  4794. Command A:  POLYPHONIC AFTERTOUCH
  4795. ---------------------------------
  4796.  
  4797. Changes  the  polyphonic  aftertouch  of  the  most  recent  note.  (Aftertouch is
  4798. squeezing  a  key down harder than when it was initally struck).  The value should
  4799. be 00 - 7F.
  4800.  
  4801.     C-3 40000
  4802.     --- 00A30 <- aftertouch $30 (remember, hex!)
  4803.     --- 00000
  4804.     --- 00A00 <- aftertouch $00
  4805.  
  4806.  
  4807. Command C:  SET VOLUME
  4808. ----------------------
  4809.  
  4810. Again,  just  to underline that the volume of a note can't be changed after it has
  4811. been played (as it can with Amiga® samples).
  4812.  
  4813. Command D:  CHANNEL PRESSURE
  4814. ----------------------------
  4815.  
  4816. This  command sends a channel pressure (channel aftertouch) message using the most
  4817. recently used channel.  The data byte should be $00 - $7F.
  4818.  
  4819. Command E:  PAN CONTROL
  4820. -----------------------
  4821.  
  4822. Controls the stereo location of the note. The data byte can be $00 - $7F.
  4823.  
  4824.     left        mid         right
  4825.      |           |            |
  4826.     00          3F           7F
  4827.  
  4828.  
  4829. Command F:  PRIMARY TEMPO / MISCELLANEOUS
  4830. -----------------------------------------
  4831. ¯
  4832. Just two additions for MIDI use:
  4833.  
  4834. FFA sends the "hold pedal on" command.
  4835.  
  4836. FFB sends the "hold pedal off" command.
  4837.  
  4838.  
  4839. Command 10:  SEND MIDI MESSAGE
  4840. ------------------------------
  4841.  
  4842. Sends a MIDI message, created using the MIDI message editor.  The data byte is the
  4843. message number.  Note that with this command the first message is number 0, so you
  4844. need to subtract one to convert the message number from the message editor for use
  4845. with this command.
  4846.  
  4847.     C-2 11000 <- send the first message, then plays note C-2 (messages are
  4848.                  always sent before notes)
  4849.  
  4850. MIDI timing pulses are sent immediately even if a message dump is going on.
  4851.  
  4852.  
  4853. Command 13:  SET PITCHBENDER WITH NOTE
  4854. --------------------------------------
  4855.  
  4856. Like command 3, but can also be used when there's a note next to the command.
  4857.  
  4858. Command 1C:  CHANGE MIDI PRESET
  4859. -------------------------------
  4860.  
  4861. Changes  the  MIDI  preset number of the current instrument.  As with all commands
  4862. which  modify  the  song  parameters,  you  should be very careful when using this
  4863. command in multi-modules (or even don't use it at all in multi- modules).
  4864.  
  4865. (See also Player Commands, 0 - 9, A - F, and 11 - 1F)
  4866.  
  4867.  
  4868. KEYBOARD SHORTCUTS
  4869. ------------------
  4870.  
  4871. "Keyboard  shortcuts" are combinations of keys used to carry out the equivalent of
  4872. a  mouse  operation.  The mouse operation may be selecting a menu item, clicking a
  4873. gadget  etc.    Hence you are "taking a shortcut" by using the keyboard instead of
  4874. using the mouse.
  4875.  
  4876. Perhaps  the  simplest  form of keyboard shortcuts are menu item shortcuts.  These
  4877. are displayed in the menu itself, as a strange-looking "A" and a letter.  All menu
  4878. shortcuts  are  accessed  by  holding  down  the  Right Amiga key and pressing the
  4879. appropriate  key.    The "A" symbol represents the Right Amiga key, and the letter
  4880. represents  the  appropriate  key.   Note that the menu shortcuts can only be used
  4881. when the main screen is active (that is, when no windows are active).
  4882.  
  4883. Shortcuts  can  also  be  attached  to  gadgets in windows and on the main screen.
  4884. These  shortcuts  are  accessed  by holding down the Left Alt key and pressing the
  4885. appropriate  key.   This time, the appropriate key is represented by an underlined
  4886. letter  in  or beside the gadget that the shortcut acts on.  This type of shortcut
  4887. can  only  be  accessed  when  the  window or main screen containing the gadget is
  4888. active.    The  effect  of  shortcuts  on  the various types of gadget in the user
  4889. interface can be found in Gadget Shortcuts.
  4890.  
  4891. Other shortcuts are not visually represented on the OctaMED screen, but have to be
  4892. remembered  by  the  user.   A full list of shortcuts is provided in the following
  4893. topics:
  4894.  
  4895. Menu Item Shortcuts       
  4896. Editing Shortcuts         
  4897. Cursor Movement Shortcuts 
  4898. Other Shortcuts           
  4899.  
  4900. IMPORTANT NOTE FOR USERS OF NON-U.S. AND NON-BRITISH KEYBOARDS
  4901.  
  4902. Menu Item Shortcuts
  4903.  
  4904. All  keys  listed have to be pressed with the Right Amiga key held.  Note that you
  4905. may only use these shortcuts when the main screen is active.
  4906.  
  4907. [ V4 upgraders: all shortcuts are  aside from cut/copy/paste track ]
  4908.  
  4909.  
  4910. A       Open Input Map Editor window
  4911. B       Open Block Properties window
  4912. C       Copy track
  4913. D       Delete file
  4914. E       Note echo
  4915. F       Spread notes
  4916. G       Open MIDI Message Editor window
  4917. H       Open Song Options window
  4918. I       Load instrument(s)
  4919. I       (with Shift+Amiga held) Load non-halved instrument(s) in 5-8 channel
  4920. K       Open Keyboard Options window
  4921. L       Open Sample List Editor window
  4922. M       MIDI Active on/off
  4923. N       New project
  4924. O       Open project
  4925. P       Open Print Options window
  4926. Q       Quit OctaMED
  4927. R       Open Relative Track Volumes window
  4928. S       Open Save Options window
  4929. T       Open Transpose window
  4930. U       Input Active on/off
  4931. V       Paste track
  4932. W       Open Mouse Options window
  4933. X       Cut track
  4934. Y       Open Programmable Keys window
  4935. Z       Swap track with copy buffer
  4936.  
  4937. 1       Ext Sync on/off
  4938. 2       Send Sync on/off
  4939. 3       Send Active Sensing on/off
  4940. 4       Send Out Input on/off
  4941. 5       Read Key Up's on/off
  4942. 6       Read Volume on/off
  4943.  
  4944. \       Open Input Channel window
  4945. [       Local Control on
  4946. ]       Local Control off
  4947.  
  4948. Note  that  the following Left Alt shortcuts also act as menu item shortcuts (with
  4949. the main screen active):
  4950.  
  4951. B       Open Block List window
  4952. C       Open Section List window
  4953. E       Open Sample Editor window
  4954. G       Open Song Selector window
  4955. I       Open Instrument Parameters window
  4956. Q       Open Playing Sequence window
  4957. T       Open Instrument Type window
  4958. Y       Open Synthetic Sound Editor window
  4959.  
  4960. Other  menu  item  shortcuts  (excluding  settings)  are  documented  in the other
  4961. keyboard shortcut topics.
  4962.  
  4963.  
  4964. Gadget Shortcuts
  4965.  
  4966. This short topic describes the effects of "Left Alt" shortcuts on the two types of
  4967. gadget  that  Left  Alt  shortcuts currently affect.  (In the future, all types of
  4968. gadget will likely be supported).
  4969.  
  4970.  
  4971.          Gadget Type   | Effect on holding Left Alt
  4972.        ----------------+----------------------------
  4973.         Action button  |       Action executed
  4974.                        |
  4975.         Check box      |  Box checked / unchecked
  4976.  
  4977.  
  4978.  
  4979. Editing Shortcuts
  4980.  
  4981. These shortcuts are used in editing with the Tracker editor.
  4982.  
  4983. Esc             Editing on/off
  4984. Shift-Esc       Chord on/off
  4985. ~               Space on/off
  4986.  
  4987. Del             Delete note or command digit under cursor
  4988. Shift-Del       Delete note and command digits
  4989. Alt-Del         Delete only command digits
  4990.  
  4991. Left Amiga-Del  
  4992. Delete  chord.  When L-Amiga is held down, every time you press Del the note under
  4993. the  cursor  is  deleted  and  the  cursor moves to the next selected track.  When
  4994. L-Amiga  is  released,  the  cursor  advances  (in the way defined in the Keyboard
  4995. Options.
  4996.  
  4997. Return or A     
  4998. Insert hold symbol (-|-)
  4999.  
  5000. Shift-Return    
  5001. Insert hold symbols to all tracks of the previous chord.
  5002.  
  5003. F               
  5004. Insert / play note at default pitch
  5005.  
  5006. Backspace       
  5007. Delete note and move following notes up
  5008.  
  5009. Shift-Backsp    
  5010. Insert empty note slot
  5011.  
  5012. Alt-Backspace   
  5013. Delete current track
  5014.  
  5015. Alt-Shift-Bksp  
  5016. Insert new track
  5017.  
  5018. Shift- 0 - 9    
  5019. Enter  programmable  key  0  - 9 (Note: with Caps Lock on, progkeys may be entered
  5020. without holding the Shift key)
  5021.  
  5022. Shift-Ctrl-0-9  
  5023. Pick note under cursor as programmable key 0 - 9
  5024.  
  5025. Tab             
  5026. Highlight current line
  5027.  
  5028. Ctrl-O          
  5029. Create volume slide (using command C)
  5030.  
  5031. Shift-Ctrl-O    
  5032. Create generic slide (using any command)
  5033.  
  5034. Ctrl-T          
  5035. Create type 1 slide (using command 3)
  5036.  
  5037. Shift-Ctrl-T    
  5038. Create type 2 slide (using commands 1 and 2)
  5039.  
  5040. Shift-Alt-X     
  5041. Cut block
  5042.  
  5043. Shift-Alt-C     
  5044. Copy block
  5045.  
  5046. Shift-Alt-V     
  5047. Paste block
  5048.  
  5049. Ctrl-Z          
  5050. Erase range
  5051.  
  5052. Ctrl-X          
  5053. Cut range
  5054.  
  5055. Ctrl-C          
  5056. Copy range
  5057.  
  5058. Ctrl-V          
  5059. Paste range
  5060.  
  5061. Shift-Ctrl-V    
  5062. Paste to selected tracks
  5063.  
  5064. Ctrl-B          
  5065. Range current track
  5066.  
  5067. Shift-Ctrl-B    
  5068. Range current block
  5069.  
  5070. Ctrl-J          
  5071. Join block with next
  5072.  
  5073. Shift-Ctrl-J    
  5074. Split block at cursor
  5075.  
  5076. Ctrl- <         
  5077. Swap  note under cursor with following note, taking account of the current spacing
  5078. value
  5079.  
  5080. Ctrl- >         
  5081. Swap notes on adjacent tracks
  5082.  
  5083. Ctrl-K          
  5084. Kill notes to end of track
  5085.  
  5086. Shift-Ctrl-K    
  5087. Kill notes to end of block
  5088.  
  5089. Alt-Ctrl-K      
  5090. Kill  notes to end of block and actually remove the deleted part of the block.  In
  5091. other words, the current line becomes the last line of the block.
  5092.  
  5093.  
  5094. Cursor Movement Shortcuts
  5095.  
  5096. These shortcuts allow cursor movement in the Tracker editor.  The cursor keys move
  5097. the cursor one place up/down/left/right.
  5098.  
  5099. Alt-<left>          Cursor to previous track
  5100. Alt-<right>         Cursor to next track
  5101. Ctrl-<left>         Previous screenful of tracks
  5102. Ctrl-<right>        Next screenful of tracks
  5103. Shift-Ctrl-<left>   Cursor to track 0
  5104. Shift-Ctrl-<right>  Cursor to last track
  5105. Shift-<up>          Previous block
  5106. Shift-<down>        Next block
  5107. Left Alt-<up>       First block  (Can't use R.Alt to avoid accidental
  5108. Left Alt-<down>     Last block    jump when using Alt-<left>/<right>)
  5109. Ctrl-NM(            Previous song         (NM = numeric keypad)
  5110. Ctrl-NM)            Next song / Add song
  5111. Shift-Ctrl-NM(      Delete last song
  5112. Shift-Ctrl-NM)      Add song with no confirmation requester
  5113.  
  5114. F6                  Cursor to first line of block
  5115. F7                  Cursor to second quarter of block
  5116. F8                  Cursor to middle of block
  5117. F9                  Cursor to last quarter of block
  5118. F10                 Cursor to last line of block
  5119.  
  5120. Alt-Ctrl-<left>     Go to where sample previously appeared in the
  5121.                     song. The sample number is taken from either the
  5122.                     number under the cursor, or (if that is
  5123.                     "--- 00000") from the current instrument number
  5124. Alt-Ctrl-<right>    Go to where sample next appears in the song
  5125.  
  5126.  
  5127. Other Shortcuts
  5128.  
  5129. Shift-Alt-Space     Play song        [ Remember you may also use the
  5130. Shift-Space         Continue song      Left Alt shortcuts underlined
  5131. Amiga-Space         Play block         in the playing gadgets ]
  5132. Alt-Space           Continue block
  5133. Space bar           Stop playing
  5134.  
  5135. Ctrl-Space bar      Reset MIDI presets / pitchbenders / mod. wheels
  5136.  
  5137. Shift-<left>        Previous sample
  5138. Shift-<right>       Next sample
  5139. Alt-Shift-<left>    16 samples backward
  5140. Alt-Shift-<right>   16 samples forward
  5141. Shift-Ctrl- <       Previous free sample slot
  5142. Shift-Ctrl- >       Next free sample slot
  5143.  
  5144. F1 - F5             Select octaves 1+2 - 5+6 in normal mode,
  5145.                     3+4 - 7+8/8+9/9+A in MIDI mode
  5146.  
  5147. Ctrl- - (minus)     Decrease primary tempo
  5148. Ctrl- + (plus)      Increase primary tempo
  5149. Shift-Ctrl- -       Decrease secondary tempo
  5150. Shift-Ctrl- +       Increase secondary tempo
  5151.  
  5152. Ctrl-I              Insert new block
  5153. Shift-Ctrl-I        Insert new default block
  5154. Ctrl-N              Append new block
  5155. Shift-Ctrl-N        Append new default block
  5156. Ctrl-D              Delete current block
  5157. Shift-Ctrl-D        Delete last block
  5158.  
  5159. Ctrl-S              Save IFF instrument
  5160. Shift-Ctrl-S        Save raw instrument
  5161. Ctrl-G              Flush current instrument
  5162. Shift-Ctrl-G        Flush all unused instruments
  5163.  
  5164. Ctrl-A              Automatic Advance Down on/off
  5165. Ctrl-F              Display free memory
  5166.  
  5167. Alt-~               Set spacing value to length of current range - 1.
  5168.                     For example,  marking a range from 000 - 002 sets
  5169.                     spacing to 2. It's logical to subtract 1 since
  5170.                     with a spacing of 2, the cursor skips from line
  5171.                     000 to 002 which is 3 lines long).
  5172.  
  5173. The following shortcuts apply to the numeric keypad.
  5174.  
  5175. Ctrl-8              Scroll playing sequence up
  5176. Ctrl-2              Scroll playing sequence down
  5177. Ctrl-4              Decrease the current playing sequence entry
  5178. Ctrl-6              Increase the current playing sequence entry
  5179. Ctrl-7              Top of playing sequence
  5180. Ctrl-1              Bottom of playing sequence
  5181. Ctrl-5              Insert current block to playing sequence
  5182. Ctrl-0              Duplicate current playing sequence entry
  5183. Ctrl-.              Delete current playing sequence entry
  5184.  
  5185. Note  that  with  the  Caps  Lock  on,  the playing sequence can be edited without
  5186. holding down the Ctrl key.
  5187.  
  5188. The non-shifted functions of the keypad are listed in Keyboard Options.
  5189.  
  5190.  
  5191. IMPORTANT NOTE FOR USERS OF NON-U.S. AND NON-BRITISH KEYBOARDS
  5192.  
  5193. The  keyboard shortcuts used in these instructions correspond to the standard U.S.
  5194. keymap  (and,  by  coincidence, to the British keymap).  Users of other keyboards,
  5195. therefore, have slight changes to make to the keys given.  They are:
  5196.  
  5197. A = Q on a French keyboard
  5198. Z = W on a French keyboard, and Y on a Swiss or German keyboard
  5199.  
  5200. <  and > are the two keys immediately to the right of M (except French, where they
  5201. are the two keys to the right of ",")
  5202.  
  5203. - and + are the two keys immediately to the right of 0 (zero)
  5204.  
  5205. *  Note  that  these changes DON'T apply to the Right Amiga menu shortcuts or Left
  5206. Alt  gadget  shortcuts.   For example, to open the Input Map Editor window using a
  5207. French  keyboard,  hold  down the Right Amiga key and press the key immediately to
  5208. the right of the Tab key (A).
  5209.  
  5210. Other  international  keyboard  differences  currently  don't  apply  to OctaMED's
  5211. keyboard shortcuts.
  5212.  
  5213.  
  5214. INTRODUCTION AND MISCELLANEOUS NODES
  5215.  
  5216. Introduction
  5217.  
  5218. Welcome  to  OctaMED  Professional V5.0!  The "MED" in "OctaMED" stands for "Music
  5219. EDitor",  and  that's  exactly  what OctaMED is.  With the program you may compose
  5220. music for games, demos, animations and presentations, or simply use the program as
  5221. a stand-alone editor.
  5222.  
  5223. There  is  little previous Amiga® knowledge you need to use OctaMED, but a general
  5224. familiarity  with  the  Amiga®  is helpful.  You should know the basic mouse-using
  5225. terms  "click"  and "drag", know about using windows and menus, know the operation
  5226. of  the  ASL  file  requester,  and  be able to copy and format disks.  If you are
  5227. unfamiliar  with any of these, please consult your Amiga®'s manual.  Communication
  5228. with the program is covered in the User Interface topic.
  5229.  
  5230. You  must  also  remember  which processor your Amiga® uses.  The A1200 contains a
  5231. 68020  processor,  and the A3000 and A4000 either a 68030 or 68040.  Other Amigas®
  5232. (without  accelerator boards fitted) use 68000 processors.  In addition to this, a
  5233. few  functions  in  OctaMED  are  selected with the mouse using a technique called
  5234. "shift-clicking".    This  simply  involves holding down one of the Amiga®'s Shift
  5235. keys while pressing and releasing the left mouse button quickly.
  5236.  
  5237. Before you begin using OctaMED, you must make a copy of the program disk and store
  5238. the  original disk in a safe place.  This serves as a precaution in case your copy
  5239. of OctaMED becomes corrupt.  The original disk should only be used to make further
  5240. copies.  ( for your OWN use )
  5241.  
  5242.  
  5243. A brief overview of the program
  5244. -------------------------------
  5245.  
  5246. OctaMED  is used to create "songs" (which are also known as "modules").  Each song
  5247. consists  of  small  pieces of music called "blocks", which are linked together by
  5248. creating  a  list  of blocks arranged in the order in which they should be played.
  5249. Blocks can be played in any order, and any number of times.  In this way a song is
  5250. broken  down  into  more  manageable pieces; and if a song contains parts that are
  5251. repeated,  you  need  only  create  the duplicated section once, and then tell the
  5252. computer to play it as often as required.
  5253.  
  5254. Blocks  are  usually  edited  using  the  Tracker  editor,  in  which the music is
  5255. represented  by note names and numbers.  In this form, the music is quite fast and
  5256. convenient to edit (when you get used to it!), but it has limited use when printed
  5257. since no-one could play it (although printing is still possible).
  5258.  
  5259. For  those who read music and wish to compose using the more traditional format of
  5260. notes placed on a stave, a notation editor is provided for this purpose.  However,
  5261. the Tracker editor is still very important so learning to use it is essential.
  5262.  
  5263. Usually  songs  are  played using the Amiga®'s internal stereo sound chip, but you
  5264. may  also  use  a  MIDI keyboard.  For sound chip use, the instruments used in the
  5265. song usually consist of digitized sounds known as "samples".  A sample can consist
  5266. of  any  sound  at all: it could be a single note, a chord, speech, sound effects,
  5267. anything!    Using  OctaMED and a "sound sampler" (which you must buy separately),
  5268. you  can create new samples by simply connecting the sound source to the sampler. 
  5269. Alternatively  you  can use the many thousands of samples already available, which
  5270. are  obtained  through  various distribution channels such as the public domain or
  5271. commerical companies.
  5272.  
  5273. OctaMED  can  be  thought of as a player of samples in a predetermined sequence at
  5274. predetermined pitches on predetermined sound channels.  (Of course, you - the user
  5275. -  determine these factors).  Since samples are played in a set sequence, programs
  5276. like  OctaMED  are  often  referred  to  as "sample sequencers".  OctaMED produces
  5277. different  pitches by simply playing the samples at a quicker or slower speed: the
  5278. quicker  the  speed,  the  higher  the pitch.  These pitches of samples are called
  5279. "notes"  (no matter whether the sample really is a single note or instead a chord,
  5280. speech etc.).
  5281.  
  5282. OctaMED  has  a  special function for use with samples that is virtually unique in
  5283. programs of its type.  Normally the Amiga®'s sound chip can play only four samples
  5284. simultaneously, but in OctaMED you can play up to eight samples at once.  Although
  5285. this  may  sound rather attractive, there is a small price to pay in sound quality
  5286. and  in  various  restrictions  (which  are documented in 5-8 Channel Mode).  (The
  5287. "Octa" in OctaMED's name refers to the eight simultaneous samples).
  5288.  
  5289. (Remember,  click  on  any  boxed  text  to  see  more  details on that topic.  In
  5290. addition, pressing Return chooses the topic highlighted in blue).
  5291.  
  5292.  
  5293. [  Please  note  that  although this guide will be of great assistance in learning
  5294. where and how!, it is no substitute for the OctaMED Companion.  The Companion is a
  5295. manual  containing full "get-you-started" instructions and then goes through every
  5296. aspect  of OctaMED right up to the truly technical stuff and if followed properly,
  5297. by  the  time  you have finished you will know how to use/write/compose as good as
  5298. anyone else.
  5299.  
  5300. The  Tutorial  is  not  a  printout  of  this text file, but is instead a complete
  5301. teach-yourself manual and we have spent many months preparing it.
  5302.  
  5303. To purchase the tutorial and its accompanying two disks please contact SeaSoft for
  5304. availability or Ray Burt-Frost ( RBF Software )
  5305.  
  5306. How are songs made?
  5307. -------------------
  5308.  
  5309. 1. Load instruments
  5310. -------------------
  5311.  
  5312. There  can  be up to 63 instruments in a song, and they are numbered 01 - 1V.  The
  5313. numbering  works  as  follows:  01, 02, 03 ...  09, 0A, 0B ...  0V, 10, 11, 12 ...
  5314. 19, 1A, 1B ...  1V.
  5315.  
  5316. Just  below  the  title  bar  of  the OctaMED screen is a small box containing the
  5317. current  sample's  number,  followed by a text box containing the current sample's
  5318. name.    The  previous or next instrument can be selected by holding the Shift key
  5319. down and pressing the left or right cursor (arrow) key respectively.
  5320.  
  5321. A  sample  can  be  loaded  into  the current instrument slot by either typing its
  5322. filename  into  the text box, or clicking the small gadget immediately to the left
  5323. of  the  text  box: you may now choose its filename using the file requester.  The
  5324. instruments  on  your  sample disks may also be organized into a list known as the
  5325. sample list for easy loading (see the Sample List Editor).
  5326.  
  5327.  
  5328. 2. Set block size, number of tracks etc.
  5329. ----------------------------------------
  5330.  
  5331. See the Tracker Editor for more information on this.
  5332.  
  5333. 3. Set instrument parameters
  5334. ----------------------------
  5335.  
  5336. Instrument  characteristics  such  as  tuning and volume are set in the Instrument
  5337. Parameters window.
  5338.  
  5339. 4. Edit blocks and add new blocks
  5340. ---------------------------------
  5341.  
  5342. As previously mentioned, blocks are edited predominantly using the Tracker editor.
  5343. New blocks can be created using the Block List window, or by using Block Menu/New.
  5344. (This means using the New item in the Block menu).
  5345.  
  5346. 5. Link blocks together
  5347. -----------------------
  5348.  
  5349. The  list  of  block numbers used to order the playing of a song is created in the
  5350. Playing Sequence window.
  5351.  
  5352. 6. Play song
  5353. ------------
  5354.  
  5355. The  song playing gadgets are located on the upper screen.  You may play the whole
  5356. song  or  just  the  current block, or continue the song or block from the current
  5357. position.
  5358.  
  5359. 7. Save song
  5360. ------------
  5361.  
  5362. There's  no  point  in  creating  a  masterpiece  if it can't be saved!  Saving is
  5363. achieved  using  the Save Options window, where you may select what format to save
  5364. the song in, whether the song is to be compressed etc.
  5365.  
  5366. Multi-modules
  5367. -------------
  5368.  
  5369. "Multi-modules"  are projects containing more than one song.  Each song shares the
  5370. same set of instruments.  This allows you, for example, to compose different songs
  5371. for  each  level  of a game, without having to load or keep the same instrument in
  5372. memory more than once.
  5373.  
  5374. Multi-modules  are  also  very useful when editing just one song, as you can treat
  5375. one  song  in  the  multi-module  as  "workspace", much like Deluxe Paint's "spare
  5376. screen"  option.    You  may design and compose in one song, then cut and paste to
  5377. another.
  5378.  
  5379. Songs  are  added  by using either the relevant gadgets on the upper screen or the
  5380. Song Selector window.
  5381.  
  5382. OctaMED  can automatically remap instruments while loading.  This feature can save
  5383. you  a lot of work.  If you have one or more songs already in memory, and you load
  5384. an additional song, a "Remap instruments?" requester will appear.
  5385.  
  5386. If  you  click  "No"  in  the  requester,  all  previous instruments in the entire
  5387. multi-module  will  be  lost  and  the instruments of the new song will be loaded.
  5388. This  could  be  used, for example, to use the new, different instruments with the
  5389. other songs in the module.
  5390.  
  5391. But if you reply "Yes": firstly, the instruments of the new song will be loaded to
  5392. empty  slots, i.e.  instruments already in memory will be preserved; secondly, the
  5393. instrument  numbers  of the loaded song will be remapped so that they point to the
  5394. new  instrument  places.   This means that the several sets of instruments used in
  5395. the several songs can be contributed to one large overall set of instruments.
  5396.  
  5397. Some other features of OctaMED
  5398. ------------------------------
  5399.  
  5400. *  Friendly  and   reasonably   simple   appearance   (considering   the program's
  5401. complexity!): see the User Interface
  5402.  
  5403. *   Numerous   editing   operations,   including   Cut/Copy/Paste   as    found in
  5404. wordprocessors,  note  transposition  etc.   (see Block Menu, Track Menu, and Edit
  5405. Menu)
  5406.  
  5407. *  Sample  waveforms  can be edited and digitized in the sample editor, and simple
  5408. synthetic instruments may be designed using the synthetic sound editor
  5409.  
  5410. *  The relative volume of each track and the overall song volume can be altered in
  5411. the Track Volumes window
  5412.  
  5413. *  MIDI  may  be  used,  with  up  to 64 notes played simultaneously and many MIDI
  5414. settings and operations (including a MIDI Message editor)
  5415.  
  5416. *  Complete  PowerPacker  and  SFCD-compression load support: OctaMED can load and
  5417. decrunch  any  PowerPacked  or  SFCD-compressed  file.    (The only file you can't
  5418. compress, unfortunately, is this one: OctaMED.guide).
  5419.  
  5420. OctaMED has built-in compression facilities for songs, but currently not for other
  5421. files.  To compress other files, you must use either the PowerPacker program (from
  5422. UGA  software, distributed by various companies) or the PowerPlayer Music Cruncher
  5423. (for SFCD-compression, included on e.g.  Fish 769).
  5424.  
  5425. Requires  powerpacker.library  for  PowerPacker,  and  lh.library  for SFCD.  Both
  5426. libraries  included  on  OctaMED's distribution disk under previous agreement with
  5427. the  copyright  owners.  The full PowerPlayer distribution archive can be found on
  5428. Fish disk 769 (ask your favourite public domain library).
  5429.  
  5430. *  Numerous  keyboard  shortcuts  exist.   Note the conventions used: for example,
  5431. "Ctrl-A"  means  "hold  down  the  Ctrl key and press the A key"; also, the cursor
  5432. (arrow) keys are represented by <left>, <right>, <up> and <down>.
  5433.  
  5434. In  order  to  learn  how  to  use the program, we suggest that you study the Main
  5435. Screen  topics  first,  and  then  perhaps  the User Interface topic.  Then simply
  5436. experiment!    If you find something you don't understand, just press the Help key
  5437. and  select the appropriate topic.  For example, if you don't quite understand the
  5438. function  of  the Input Map Editor window, select "Windows" from the contents page
  5439. then select "Input Map Editor" from the Windows topic.
  5440.  
  5441. (Please  ignore the occasional word "" that you might find: it simply indicates to
  5442. upgraders from V4 which features are new to V5.0).
  5443.  
  5444. We hope you will find this program useful and enjoy it!
  5445.  
  5446. P.S.  In this help file (and in many other computer documents and bulletin boards)
  5447. you may come across odd-looking symbols, often consisting of a semicolon or colon,
  5448. an optional hyphen and a closed bracket.  To understand these, just tilt your head
  5449. 90 degrees to the left :-)
  5450.  
  5451.  
  5452. 5 - 8-Channel Mode
  5453.  
  5454. (Parts of this topic are really intended as a reference for more experienced users
  5455. of OctaMED, so don't worry if you don't understand everything at the moment!)
  5456.  
  5457. The  Amiga®  has  four  stereo  sound channels in its sound chip, and through each
  5458. channel one note can be played at once.
  5459.  
  5460. 5  -  8-channel  mode works by mixing two samples in real time and then outputting
  5461. them through one sound channel.  This takes up a lot of the processor's power, and
  5462. the  mixing process reduces the sound quality (causes distortion).  The distortion
  5463. can  be reduced using High Quality Mode or (as a last resort ;) by using the audio
  5464. filter (both selected in Song Options, and channel mode changing is also contained
  5465. in this window).
  5466.  
  5467. The  processor  load that 5 - 8-channel playing causes, and some technical reasons
  5468. set some limitations to playing in these modes:
  5469.  
  5470. *  Different  playing  speed selection.  Use the secondary tempo as usual, but use
  5471. primary tempo values 1-10.
  5472.  
  5473. * Synthetic / hybrid sounds can't be used
  5474.  
  5475. * All equalizers are disabled
  5476.  
  5477. * All MIDI features are disabled
  5478.  
  5479. * Instrument  default  volume  and Decay values are ignored, as are the track and
  5480.   master volumes
  5481.  
  5482. *  Limited  sample  loop  length,  only  in  a minimum of 200-byte steps (when the
  5483. primary  tempo  is 1).  Every time the primary tempo is increased by one, the loop
  5484. length byte-steps increases by 20.  So with a primary tempo of the maximum 10, the
  5485. length is set in 400-byte steps.
  5486.  
  5487. In  addition  to  this, samples should be "halved".  This means that each sample's
  5488. volume  should  be  half  of its normal volume, so that they can be mixed with the
  5489. minimum  of  distortion.   The halving is done automatically when changing channel
  5490. mode (answer "Halve" in the requester).
  5491.  
  5492. The  sound channels that play these mixed samples are called "split channels".  In
  5493. eight-channel  mode  all  channels  are  split, but in five- channel mode only one
  5494. channel  is  split,  allowing  better quality samples on the other three channels.
  5495. You  may  use  non-halved  samples  on  non-split  channels, but attempting to use
  5496. non-halved  samples  on  split  channels  when two notes are played simultaneously
  5497. usually creates awful noise.
  5498.  
  5499. The channel configuration in each of the channel modes is as follows:
  5500.  
  5501.   ( S = split, N = non-split, (L) = left speaker, (R) = right, - = unused )
  5502.  
  5503. Channels    0       1       2       3       4       5       6       7
  5504. +-------+-------+-------+-------+-------+-------+-------+-------+-------+
  5505. |   4   | N (R) | N (L) | N (L) | N (R) |   -   |   -   |   -   |   -   |
  5506. +-------+-------+-------+-------+-------+-------+-------+-------+-------+
  5507. |   5   | S (R) | N (L) | N (L) | N (R) | S (R) |   -   |   -   |   -   |
  5508. +-------+-------+-------+-------+-------+-------+-------+-------+-------+
  5509. |   6   | S (R) | S (L) | N (L) | N (R) | S (R) | S (L) |   -   |   -   |
  5510. +-------+-------+-------+-------+-------+-------+-------+-------+-------+
  5511. |   7   | S (R) | S (L) | S (L) | N (R) | S (R) | S (L) | S (L) |   -   |
  5512. +-------+-------+-------+-------+-------+-------+-------+-------+-------+
  5513. |   8   | S (R) | S (L) | S (L) | S (R) | S (R) | S (L) | S (L) | S (R) |
  5514. +-------+-------+-------+-------+-------+-------+-------+-------+-------+
  5515.  
  5516. Note  that  5  - 8 channel mode does NOT mean how many tracks there are.  You must
  5517. also select 5 - 8 tracks in the Block Properties window.
  5518.  
  5519. For best results, you shouldn't use more channels than you need.  If, for example,
  5520. your  song  doesn't  use more than six tracks at once, you should select 6-channel
  5521. mode  instead of 7 or 8-channel mode.  This both increases the execution speed and
  5522. gives you two non-split (i.e.  high quality) tracks (2 and 3).
  5523.  
  5524. If you load additional samples while in 5 - 8-channel mode, OctaMED usually halves
  5525. them  automatically.    However, if you are using some channels that aren't split,
  5526. you  can  override  halving  and  load  normal-volume  samples  for  the non-split
  5527. channels.  To do so, hold down the Shift key when:
  5528.  
  5529. a) clicking on a sample name in the Load Instrument Window
  5530. b) clicking Load Inst in the Sample List Editor window
  5531. c) selecting Load Instrument(s) from the Instr menu
  5532. d) clicking the getfile gadget on the top row of the upper screen
  5533.  
  5534. Volume limitations
  5535. ------------------
  5536.  
  5537. Because  there  are  only  4 sound channels and 4 volume registers, pairs of split
  5538. channels must share each volume register.  Channels 0 and 4, 1 and 5, 2 and 6, and
  5539. 3 and 7 each share one register.  This means that every volume command (C) affects
  5540. two tracks.  For example:
  5541.  
  5542. Track:     0         1         2         3         4
  5543.     000 C-1 30000 E-1 30000 G-1 30000 --- 00000 A#2 50C20
  5544.  
  5545. The  0C20  command  on track 4 affects both tracks 4 and 0.  The default volume of
  5546. instruments is ignored for this reason.
  5547.  
  5548.  
  5549. To those upgrading from version 4...
  5550.  
  5551. Welcome  to  another  version  of OctaMED!  Firstly: as I'm sure you'll know, this
  5552. version  and all subsequent versions will require Kickstart and Workbench 2.x "TM"
  5553. or  higher.    This  is because OctaMED now heavily depends on the new features in
  5554. Release  2  of  the  operating  system,  and  many  parts of the program have been
  5555. entirely  rewritten to take advantage of them.  As 2.04 upgrade packages have been
  5556. available  for  more  than 1½ years, it's a reasonable assumption that every truly
  5557. serious  Amiga®  user  has  the package available to them.  (Please note that THIS
  5558. disk  contains  WB  2.1  "TM").    However, OctaMEDPlayer is still compatible with
  5559. Kickstart  1.3  "TM"  to  allow  your  songs to be heard by as wide an audience as
  5560. possible.
  5561.  
  5562. So you've got your copy of V5.0, and you're probably wondering what has changed.
  5563.  
  5564. Well,  as  soon as you loaded OctaMED, you'll have noticed a huge change: the user
  5565. interface  has  been completely rewritten.  This not only gives the program a much
  5566. more  "friendly"  appearance,  but  it  enables  more  features to be added to the
  5567. program  more  easily.   While in OctaMED V4, gadgets had to be shrunk to make way
  5568. for new functions, in future versions a window simply needs to be enlarged.
  5569.  
  5570. Where the V4 features can be found
  5571. ----------------------------------
  5572.  
  5573. Here is a list of which windows the V4 panels' features have been moved to:
  5574.  
  5575. Status bar:     
  5576. Upper screen
  5577.  
  5578. Lower status:
  5579. Free memory    :   Lower screen
  5580. Block name     :   Block Properties window, Block List win
  5581. Song name      :   Song Options window
  5582.  
  5583. Files:
  5584. Load song      :   Project menu/Open
  5585. Save song      :   Save Options window
  5586. Del file       :   Project menu
  5587. Load/Save instr:   Instr menu
  5588. Load/Save msg  :   MIDI Message Editor
  5589. Load/Save map  :   Input Map Editor
  5590.  
  5591. Play:
  5592. Playing seq    :   Playing Sequence window
  5593. Chan mode, Vol,
  5594.   Filter, STS  :   Song Options window
  5595. Equalizers
  5596.   (note: no E1):   Settings menu
  5597. All others         Upper screen
  5598.  
  5599. Instr:
  5600. Type           :   Type window
  5601. Name           :   Upper screen (use to reload instruments)
  5602. All others     :   Instrument Parameters window
  5603.  
  5604. Block:
  5605. Trks, Lines    :   Block Properties window
  5606. Highlighting   :   Highlight Options window
  5607. Del Buff       :   Edit menu
  5608. All others     :   Block menu, Track menu
  5609.  
  5610. Edit:
  5611. Prog keys      :   Programmable Keys window
  5612. Track on/off   :   Upper screen
  5613. All others
  5614.  (no Octaves)  :   Keyboard Options window
  5615.  
  5616. Misc:
  5617. Clear gadgets  :   New Project window
  5618. Quit           :   Project menu
  5619. Palette        :   Palette Window
  5620. PTKey          :   Keyboard Options window
  5621. Add / Rem Paths:   Instr menu
  5622. Mouse2         :   Mouse Options window
  5623. All others
  5624. (no Dep2/LdGfx):   Settings menu
  5625.  
  5626. Vol:
  5627. Track Volumes window
  5628.  
  5629. MIDI:
  5630. Chan/preset,
  5631.   supp. noteoff:   Instrument Parameters window
  5632. Message editor :   MIDI Message Editor
  5633. Input map ed   :   Input Map Editor
  5634. All others     :   MIDI menu
  5635.  
  5636. Trans:
  5637. Play transpose :   Song Options window
  5638. Annotation text:   Song menu
  5639. All others     :   Transpose window
  5640.  
  5641. Range:
  5642. Chord RST      :   Keyboard Options window
  5643. Select tracks  :   Upper screen
  5644. All others
  5645.   (no Range)   :   Edit menu
  5646.  
  5647. Synth:
  5648. Synthetic Sound Editor (note: menu attached to window)
  5649.  
  5650. SmpEd:
  5651. Sample Editor (note: menu attached to window)
  5652.  
  5653. Note: SAVE IFF has been "moved" to Instr menu/Save Instrument
  5654.  
  5655. SList:
  5656. Sample List Editor
  5657.  
  5658. Notation Ed:
  5659. Display menu/Notation Editor (menu attached to window)
  5660.  
  5661. Features removed in V5.0
  5662. ------------------------
  5663.  
  5664. You'll notice that some features from V4 are missing in V5.0:
  5665.  
  5666. a)  The  DEP2  gadget  in  the  MISC  panel has been removed.  This is because the
  5667. OctaMED screen now always has 2 bitplanes (4 colors).
  5668.  
  5669. b)  The  LOADGFX  gadget  in  the MISC panel is missing, as there are now no extra
  5670. graphics files to load...
  5671.  
  5672. c)  There  was,  unfortunately, no space using the new interface for the E1 set of
  5673. equalizers.
  5674.  
  5675. d)  The  set  of Octaves gadgets in the EDIT panel and the Range dimensions in the
  5676. RANGE  panel  were  thought  to  be  no longer necessary, but they may return in a
  5677. future version.
  5678.  
  5679. e)  The  color  palette  is  no  longer  loaded  or  saved with songs.  Loading in
  5680. particular  would  have  certainly caused problems with songs created with earlier
  5681. versions  of  OctaMED: imagine what the new interface would look like with the old
  5682. black - white - dark gray - light gray palette!
  5683.  
  5684. f)  The  old  status  bar  action  of clicking a digit with either mouse button to
  5685. increase  / decrease the digit no longer exists (it is a "non- standard" function,
  5686. and  clicking  with  the  right  mouse  button  would  interfere with the new menu
  5687. system).
  5688.  
  5689. For  those who have become used to this operation, here are some relevant keyboard
  5690. shortcuts:
  5691.  
  5692. Decrease / increase playseq position:  Ctrl - 8 / 2 (numeric keypad)
  5693. Decrease / increase block number:      Shift - <up> / <down>
  5694. Decrease / increase instrument number: Shift - <left> / <right>
  5695. Decrease / increase song number:       Ctrl - ( / ) (numeric keypad)
  5696.  
  5697. g)  The Left Alt programmable keys definition has unfortunately had to be removed,
  5698. since Left Alt is now the gadget shortcut qualifier (see Keyboard Shortcuts).
  5699.  
  5700. h) The instrument default volume's hex display has been (temporarily?) removed.
  5701.  
  5702. New features in V5.0
  5703. --------------------
  5704.  
  5705. a) Maximum sizes increased:
  5706.  
  5707. *  64 tracks in a block (you're also not limited to multiples of 4)
  5708. *  1000 blocks in a song
  5709. *  999 entries in a playing sequence
  5710. *  MIDI Preset range (1 - 2800), only works with some devices
  5711. *  1048560 bytes in a MIDI message (should be enough for most use!)
  5712.  
  5713. b) New list windows:
  5714.  
  5715. *  Song Selector displays all songs
  5716. *  Block List displays all blocks
  5717.  
  5718. c) Sample editor options:
  5719.  
  5720. *  Change volume: fade in/out, halve, double, don't clip (prevents distortion)
  5721. *  Anti-alias when changing pitch can be turned off
  5722. *  Cancel finetune (removes finetune value from a sample)
  5723. *  Set volumes of source and destination when mixing
  5724. *  Set density of pixels in pixel display mode
  5725. *  Invert: turns the range upside-down
  5726. *  Chop: deletes the whole sample except the range
  5727. *  Remove Unused Space: deletes space (of zero volume) from either side of 
  5728.    the sample
  5729. *  Create Chord: creates chords of 2 - 4 notes from a sample
  5730. *  Play Buffer Contents: plays the copy buffer at the current pitch
  5731. *  Sample Voice Monitor: optionally turns off hearing the input signal while 
  5732.    digitizing (may enhance quality on slower machines)
  5733. *  Clicking Digitize when Buffsize = 0 automatically creates a buffer (of 
  5734.    131072 bytes or the largest available if no memory)
  5735.  
  5736. d) Sample list editor options:
  5737.  
  5738. *  Instrument Load Window allows easy loading of samples in list
  5739. *  Stores tuning / MIDI / default volume values and default pitch as well 
  5740.    as loop
  5741. *  Add directories anywhere in list (not just to end)
  5742.  
  5743. e) Playing sequence:
  5744.  
  5745. *  Can create multiple playing sequences (sections), and choose the order in 
  5746.    which these sections are played in the Section List
  5747. * "Clear playing sequence" button
  5748. *  Now also displays block names
  5749. * "Follow" gadget automatically updates the list so that the current position
  5750.    is as close to the middle as possible
  5751.  
  5752. f) New save options:
  5753.  
  5754. *  A new file format (MMD2), saves song sections
  5755. *  Song  compression,  using  PowerPacker  or SFCD compression.  SFCD is a packing
  5756.    format  used  in  Stephan  Fuhrmann's PowerPlayer module player program, and it
  5757.    usually  crunches  modules slightly more tightly than PowerPacker.  It requires
  5758.    lh.library  for use, which is distributed with OctaMED under agreement with the
  5759.    copyright owners.  (PowerPlayer can be found on Fish disk 769)
  5760. *  Song size calculation
  5761. *  Save Timer emulates "auto-save" option of many wordprocessors
  5762.  
  5763. g) New editing functions:
  5764.  
  5765. *  Generic Slide creates a slide with any kind of player command (use as Volume 
  5766.    Slide except with a different player command)
  5767. *  Flush all unused instruments
  5768. *  Highlighting: starting offset and custom spacing options
  5769. *  Insert / delete tracks throughout the song
  5770. *  Automatically cancels range after an operation. Also, you now cancel a range by 
  5771.    simply clicking the mouse button on the editor
  5772.  
  5773. h) New instrument type: ExtSamples (an extra two lower octaves)
  5774.  
  5775. i) More settings:
  5776.  
  5777. *  Display max tracks: maximum tracks on-screen at once (4, 8, 16)
  5778. *  Left,  middle  and  right  mouse button can be configured to turn normal/select
  5779.    tracks on/off, set cursor position, or mark range
  5780. *  Spacing options: destructive, auto-round (Keyboard Options)
  5781. *  Turn  automatic flushing of unused instruments on/off when clearing the current
  5782.    song of a multi-module
  5783. *  Auto-Freeze  Screen:  automatically  turns screen updating off when the OctaMED
  5784.    screen is not the frontmost
  5785. *  Play After Loading: automatically starts playing directly after loading a song,
  5786.    useful for listening to other people's songs
  5787. *  AGA-compatible palette
  5788.  
  5789. j) Many new keyboard shortcuts, including some new editing functions
  5790.  
  5791. k) Smaller functions:
  5792.  
  5793. * Arrow gadgets select the previous / next set of tracks to allow all 64 tracks to
  5794.   be  used, in the upper screen, Track Volumes window and Notation Control window.
  5795.   Shift-clicking  the  gadgets  select  the first / last set of tracks used in the
  5796.   current block
  5797. *  A Project menu option to display the last title bar message
  5798. *  Can  also  change  an  instrument  into  a  synthetic sound by choosing Project
  5799.    menu/New Synthsound in the synth editor
  5800. *  Synthsound programming editing: the cursor no longer moves down beyond END; and
  5801.    inserting  any  command  except  HLT and RES (which don't take parameters) also
  5802.    inserts a new 00 value.
  5803. *  Shift-clicking  (clicking  with  Shift  held) the waveform arrow gadgets in the
  5804.    synth editor selects the first / last waveform
  5805. *  Shift-clicking  one  of the track gadgets in the upper screen "solos" the track
  5806.    (clears all tracks except the one selected)
  5807. *  Shift-clicking Cont Song continues song from top line of block
  5808. *  Shift-clicking Space turns spacing on and opens Keyboard Options (with a view to
  5809.    editing the spacing options)
  5810. *  A gadget to quickly select the current block for printing
  5811. *  Can  close  then  reopen  the  notation  editor's  options window using Display
  5812.    menu/Notation Control Window
  5813.  
  5814. l) Other new features:
  5815.  
  5816. *  Fully  localizable under Workbench 2.1 "TM" (the required 2.1 files are on this
  5817.    disk, or later.  (WB 2.04 "TM" users can now use the Locale program which is in
  5818.    Prefs on Disk2).
  5819. *  You can set a default pitch (note) for each instrument, which will be played and
  5820.    entered  at  that  pitch  when the "F" key is pressed.  Very useful for untuned
  5821.    instruments such as percussion
  5822. *  Can  load  more  than  one  instrument  at  a time: instruments are loaded into
  5823.    consecutive slots, starting at the current slot
  5824. *  Clicking  the  timer reset gadget ("R") stores the current song position, which
  5825.    can be recalled by clicking the timer itself
  5826. *  The High Quality switch now doesn't decrease the tempo
  5827. *  Supports  multiple  settings  and  programmable keys files (on startup, OctaMED
  5828.    attempts to load "S:OctaMEDPro.config" and "S:OctaMEDPro.defkeys")
  5829. *  On-line  help  provided  by pressing the Help key (you'll probably have already
  5830.    found  this  out  for  yourself ;-)
  5831.  
  5832. m)  Of  course,  numerous  bug  and  quirk  fixes,  including commands 19 and FF3,
  5833.     commands  FFD  and  FFF  in 5-8 channel mode, the effect of changing the block
  5834.     size  on  line highlighting and block names, intelligent sample halving (won't
  5835.     request  to  halve  samples  if  they are already halved) and many other small
  5836.     fixes.
  5837.  
  5838. Some  of  the  small  fixes  are:  if  an  instrument had a Hold value above zero,
  5839. entering  a  note  with  that  instrument and with spacing on cut the note a split
  5840. second  after  it  was  played;  entering a note with Space and Chord mode both on
  5841. advanced only one line; playing a range two bytes long (sample editor) appeared to
  5842. play  the  entire  chip memory!; Spread Notes also spread blank notes (--- 00000);
  5843. "advance  with  sound"  (loudspeaker gadget on the EDIT panel) played notes on all
  5844. tracks,  regardless  of the tracks' on/off status; you can no longer use a spacing
  5845. value of 1 (admit it, it was a bit useless :^).
  5846.  
  5847. One  bug of note: the "intelligent" sample loader added way back in MED 2.10 (July
  5848. 1990)  is  finally  *  REALLY * intelligent!!  :^) (It can calculate the number of
  5849. grains  of sand on Planet Earth within 3.8 seconds, work out who will be Wimbledon
  5850. champion in the year 2064, design the world's first pear-shaped Cadillac, and even
  5851. eat  a  whole  plum  without spilling a single drop of juice :'D ).  Seriously, it
  5852. promises  never  to request a sample disk more than once while loading songs saved
  5853. without their instruments.
  5854.  
  5855. In  addition,  the  old  "octamed.config"  file  can't be loaded by V5.0.  This is
  5856. because  the  format  of the config file has once again changed, but hopefully for
  5857. the  last  time  (since  the file is now a plain text file).  You need to recreate
  5858. your  old preferences using V5.0, then save the settings using the Settings menu. 
  5859. (A  list  of  the settings saved with the "OctaMEDPro.config" file is given in The
  5860. Settings  File.    Note  that the programmable keys definitions are now saved in a
  5861. separate file called "OctaMEDPro.defkeys", see the Programmable Keys window.
  5862.  
  5863. This  list  should  have covered all features new to V5.0, but throughout the help
  5864. file  the  word  ""  emphasizes these new features.  This doesn't include keyboard
  5865. shortcuts listed in the main documentation (there are too many of them!).
  5866.  
  5867.  
  5868. Keyboard shortcuts
  5869. ------------------
  5870.  
  5871. Almost  all  shortcuts  involving  Right Amiga have been either removed or changed
  5872. from  version 4, since Right Amiga is now used as a menu shortcut qualifier only. 
  5873. (The  only  exceptions  are  Amiga-X/C/V,  which  remain  as in V4: cut/copy/paste
  5874. track).  The changes are:
  5875.  
  5876. Amiga-L        (Load Song)     Now Amiga-O
  5877. Amiga-P        (Play Song)     Now Left Alt-P (with main screen active)
  5878. Amiga-T        (Slide type 1)  Now Ctrl-T
  5879. Shift-Amiga-T  (Slide type 2)  Now Shift-Ctrl-T
  5880. Amiga-O        (Volume slide)  Now Ctrl-O
  5881.  
  5882. Shift-Amiga-X/C/V  has  been changed to Shift-Alt-X/C/V for compatibility with the
  5883. new  interface  (holding Shift and choosing Cut, Copy or Paste from the Track menu
  5884. would  have  affected  the  _block_  instead!).  Aside from X/C/V, all other Amiga
  5885. shortcuts have been removed.
  5886.  
  5887. Ctrl-F1-F10 and Alt-keypad shortcuts have also been removed.
  5888.  
  5889.  
  5890. A final word
  5891. ------------
  5892.  
  5893. So  although  there  are  many  new  features,  you  should become used to the new
  5894. interface  fairly  quickly.  You could first of all read the user interface topic,
  5895. then  scan  through  all  the  menus  and  windows  in the program, noting the new
  5896. positions  of  V4's  functions and referring to the appropriate topic in this help
  5897. file if you discover anything you don't recognize.
  5898.  
  5899. Remember  that  any  menu item with the suffix "..." opens a window, and also that
  5900. there  is  a  menu bar attached to the sample, synthsound and sample list editors,
  5901. and  the Notation Control window!  Finally note that the right mouse button can no
  5902. longer  be  used  to select a range in the tracker, sample and synthsound editors:
  5903. the left mouse button now usually does this.
  5904.  
  5905. We  hope  you  find  the  new version useful, and also Kickstart 2.04 or higher if
  5906. you've just upgraded it really is well worth buying the complete 2.04 upgrade set,
  5907. IF you can find a supplier, ( especialy in the UK ).
  5908.  
  5909.  
  5910. The User Interface
  5911.  
  5912. The  "user interface" is the means by which the computer and user communicate.  In
  5913. OctaMED, this is done by using windows, menus and gadgets.
  5914.  
  5915. The user interface has been completely rewritten in OctaMED Pro V5.0, which should
  5916. make the program look a little less complicated and be easier and more "intuitive"
  5917. to  use.   ("Intuitive" means that the various controls behave as you would expect
  5918. them to).
  5919.  
  5920. "Gadgets"  are  graphics symbols used for communication with the program, and this
  5921. topic describes the various different sorts of gadget (which are handled using the
  5922. computer's "GadTools" library).
  5923.  
  5924. For  information  about using the windows and menus, please refer to your Amiga®'s
  5925. user  manual.    There  are  two  points  of note, however, about OctaMED's window
  5926. handling.   Firstly, notes can't be entered or deleted while any window is active,
  5927. even  when  editing  is switched on: you must activate the main screen.  Secondly,
  5928. the  right mouse button is equivalent to clicking the window's zoom gadget (except
  5929. in  the  sample,  synthetic sound and sample list editors and the Notation Control
  5930. window, when it displays the window's menu bar).
  5931.  
  5932. A  quick word about the screen: OctaMED's screen uses AutoScroll, which means that
  5933. if  you  have dragged its screen down, you may drag it back up again by moving the
  5934. mouse pointer off the very bottom of the screen.
  5935.  
  5936. (Note  that  the  words  "gadget"  and "button" essentially mean the same; "click"
  5937. means  "press  and  release the left mouse button quickly"; and "drag" means "hold
  5938. down the left mouse button while moving the mouse").
  5939.  
  5940.  
  5941. Action buttons
  5942. --------------
  5943.  
  5944. These  are  the simplest form of gadget, as they just perform the activity labeled
  5945. on the button.  The button's appearance is a rectangular area that is raised, i.e.
  5946. it seems to "come out" of the screen.
  5947.  
  5948. Holding  down  the  left mouse button over the gadget "inverts" it, i.e.  turns it
  5949. blue.    Releasing  the  mouse  button performs the activity.  While the gadget is
  5950. inverted,  you  may  move  the  mouse pointer away from the gadget.  This makes it
  5951. non-inverted, and the function is said to be "canceled".
  5952.  
  5953. There is a special type of action button called a "GetFile" gadget.  It is a small
  5954. gadget  containing  an diagram of a list appearing from a folder.  Clicking on one
  5955. of these gadgets opens a file requester for a particular operation.
  5956.  
  5957. Examples of GetFile gadgets are in the upper screen and the Save and Print Options
  5958. windows.
  5959.  
  5960.  
  5961. Check boxes
  5962. -----------
  5963.  
  5964. These small square gadgets allow you to choose whether an option is "on" or "off".
  5965. When  on,  a "check" (or "tick") mark appears in the gadget, and when off, the box
  5966. is empty.  To turn the option on or off, simply click inside the gadget.
  5967.  
  5968.  
  5969. Radio buttons
  5970. -------------
  5971.  
  5972. These  gadgets consist of a set of small circular buttons, collectively known as a
  5973. "radio button", with which you select one option from a variety of options.  Radio
  5974. buttons  are  "mutually  exclusive",  meaning  that one and only one option may be
  5975. selected.    When  selected  (by  clicking  on  it),  the small button is recessed
  5976. (meaning it seems to "go into" the screen), and a blue circle appears inside it.
  5977.  
  5978.  
  5979. Cycle gadgets
  5980. -------------
  5981.  
  5982. These  gadgets are equivalent in function to radio buttons, but only one option is
  5983. visible  at  a  time.    They look like action buttons, but with a "cycle" sign on
  5984. their  left-hand  side.  The various options are cycled through by clicking inside
  5985. the  gadget.    Shift-clicking  them  (clicking them with the Shift key held down)
  5986. cycles through the options backwards.
  5987.  
  5988. In  this  help  file, the default setting of each radio button and cycle gadget is
  5989. documented.
  5990.  
  5991.  
  5992. Text and numerical boxes
  5993. ------------------------
  5994.  
  5995. Also  called  "string  and  integer  gadgets",  these appear as rectangles with an
  5996. embellished  black  and  white border.  With them you may type in text and numbers
  5997. (in appearance there is no difference between text boxes and numerical boxes).
  5998.  
  5999. The  boxes  are  "activated"  by  clicking  inside  them,  and a small blue cursor
  6000. appears.    You may edit the text or number inside the box simply by typing.  When
  6001. you  have  finished  editing,  make  sure you press the Return key so that OctaMED
  6002. accepts  the  new  information.  Keyboard shortcuts that you may use while editing
  6003. are:
  6004.  
  6005. <left / right>  Move cursor left / right
  6006. Backspace       Delete "character" (letter or number) to left of cursor
  6007. Del             Delete character at cursor
  6008.  
  6009. Shift-<left>    Move to beginning of box
  6010. Shift-<right>   Move to end of box
  6011.  
  6012. Amiga-X         Delete box's contents
  6013. Amiga-Q         Restore box's contents
  6014.  
  6015. Ctrl-A          Move to beginning of box
  6016. Ctrl-Z          Move to end of box
  6017. Ctrl-X          Delete box's contents (like Amiga-X)
  6018. Ctrl-H          Delete character to left of cursor (like Backspace)
  6019. Ctrl-U or W     Delete from cursor to beginning of box
  6020. Ctrl-K          Delete from cursor to end of box
  6021. Ctrl-M          Accept edited information (like Return)
  6022.  
  6023. In  addition,  the  Tab  key  accepts  the  edited  information  (like Return) and
  6024. activates  the  next  text  or numerical box in the window.  Shift-Tab accepts and
  6025. activates the previous box.
  6026.  
  6027.  
  6028. Sliders
  6029. -------
  6030.  
  6031. Sliders  are rectangular gadgets that contain another small black rectangle.  This
  6032. small  rectangle  is  known  as the slider's "knob", and the rest of the gadget is
  6033. called  the "slider box".  Above, below, to the left or to the right of the gadget
  6034. is  a  number  (called  the "slider value"), and the gadget is used to increase or
  6035. decrease the slider value.
  6036.  
  6037. The  slider  value  is usually changed by dragging the knob.  However, clicking in
  6038. the  slider box increases or decreases the value by one (depending on where in the
  6039. box  you  click).   There may be arrows beside the slider; in which case, clicking
  6040. them increases or decreases the value by one.
  6041.  
  6042.  
  6043. Scrolling lists
  6044. ---------------
  6045.  
  6046. These are used to display a list of different names of objects.  Examples of lists
  6047. are  in  the  Playing  Sequence  window,  the Instrument Load Window, and the Song
  6048. Selector window.
  6049.  
  6050. They  consist of a box containing the list itself, a scroll gadget to the right of
  6051. the  list, and sometimes a display box (see later) or text box underneath the list
  6052. that shows the currently selected item in the list.
  6053.  
  6054. A scroll gadget is like a slider, but by dragging the black rectangle you move the
  6055. list  up or down.  Clicking in the scroll box moves the list one page up or down. 
  6056. Items in the list are selected simply by clicking on them.
  6057.  
  6058.  
  6059. Display boxes
  6060. -------------
  6061.  
  6062. These  are  the  only  type  of  gadget  listed in this topic that you can't click
  6063. inside!  They simply display information, and they appear as recessed boxes.
  6064.  
  6065. One  more  thing you should know about: ghosting.  This is when a gadget or a menu
  6066. item becomes checkered, and it means that it can't be selected.  This happens, for
  6067. example,  to  the  slider  in  the  Programmable  Keys  window  when the Right Alt
  6068. definition is being shown.
  6069.  
  6070. For the keyboard shortcuts used with gadgets, see Gadget Shortcuts.
  6071.  
  6072.  
  6073. Installation
  6074.  
  6075.  
  6076. This  topic describes which files OctaMED uses when starting up, for those wishing
  6077. to properly install the program on a hard disk or a different floppy disk.
  6078.  
  6079. ***  If  you  wish  to  install  OctaMED on a hard disk you can, of course, simply
  6080. double-click  the  Copy_To_Hard_Drive  icon  in the utilities drawer of this disk,
  6081. ensuring  that  your  hd is titled as WORK!!  If you copy the files manually, then
  6082. from  from  disk  2 you will need to copy OctaMED.Guide across to your chosen hard
  6083. disk  directory,  and also the OctaMED.config to your S directory, If you don't do
  6084. this, the OctaMED.guide won't be opened when pressing the Help key.
  6085.  
  6086. This  disk  contains  the NEW WB 2.1 "TM" files (in the C: and LIBS: drawers).  If
  6087. you are using WB 3.0 "TM" (supplied with the A1200/A4000 Amigas®), you may replace
  6088. the  2.1 files with your 3.0 files if you wish.  This is not necessary, though, as
  6089. the WB 2.1 "TM" files will work perfectly under Kickstart 3.0.
  6090.  
  6091. The only files that OctaMED actually requires to start up are version 37 or higher
  6092. of asl.library and iffparse.library, in either the current or the LIBS: directory.
  6093. If  the  following  other  files  are  also  installed, however, OctaMED will take
  6094. advantage of them:
  6095.  
  6096.        File         | Directories OctaMED searches |        Purpose
  6097. --------------------+------------------------------+-----------------------
  6098.    locale.library   |      NOT this version        | Use different language
  6099.                     |                              |
  6100.  amigaguide.library |        LIBS:, current        |      On-line help
  6101.                     |                              |
  6102.    OctaMED.guide    |         S:, current          |      On-line help
  6103.                     |                              |
  6104.      Help.guide     |         S:, current          |   AmigaGuide® help
  6105.                     |                              |
  6106. powerpacker.library |        LIBS:, current        | PowerPacker crunching
  6107.                     |                              |
  6108.      lh.library     |        LIBS:, current        |   SFCD compression
  6109.                     |                              |
  6110.      MED_paths      |         S:, current          |    The sample list
  6111.                     |                              |
  6112.  OctaMEDPro.config  |              S:              |   Default settings
  6113.                     |                              |
  6114.  OctaMEDPro.defkeys |              S:              | Default program. keys
  6115.  
  6116. Remember  that  you  can  also  store these files in directories other than S: and
  6117. LIBS: using the "Assign" command.  For example:
  6118.  
  6119.         Assign S: <path name> Add
  6120.  
  6121. where  <path name> is the path of the directory where you wish to store the sample
  6122. list and the default settings / programmable keys files.
  6123.  
  6124.  
  6125. SPECIAL PURPOSE NODES
  6126.  
  6127.  
  6128. The File Requester
  6129.  
  6130. The  file  requester  is  used  to  handle and select files.  OctaMED supports the
  6131. system-integrated  ASL  file  requester  (please refer to your Amiga®'s manual for
  6132. information).    You  may  also use, ON A COPY, file requesters that automatically
  6133. replace  the ASL file requester, for example ReqTools (when the RTPatch program is
  6134. run) and the Magic File Requester.
  6135.  
  6136. OctaMED  has two special features in all operations involving saving.  Firstly, an
  6137. "Overwrite?"  requester appears if the file OctaMED is trying to save has the same
  6138. name  as  another  file  in  the directory.  Secondly, you can't double-click on a
  6139. filename  like  you  can  when  loading:  you need to use the "Ok" gadget instead.
  6140. These two features go some way to prevent accidental file deletion.
  6141.  
  6142.  
  6143. The Settings File
  6144.  
  6145. The settings file is saved by choosing Settings Menu/Save Settings.  The following
  6146. options are saved (values in brackets are default):
  6147.  
  6148. * Save Options window:
  6149.  
  6150. - Save Secondary Data (ON)
  6151. - Create Icons (ON)
  6152. - Save Notation Data (OFF)
  6153.  
  6154. * The Save Timer value (0)
  6155.  
  6156. * Sample Editor:
  6157.  
  6158.    - Line display (ON)
  6159.    - Pixel display (OFF)
  6160.    - Pixel Density (2)
  6161.    - Sampler Voice Monitor (OFF)
  6162.    - Pitch period (428)
  6163.    - Don't Clip (Change Volume window) (OFF)
  6164.  
  6165. * The "Auto-Terminate Capture" gadget in the MIDI message editor (ON)
  6166.  
  6167. * The "Follow" gadget in the Playing Sequence window (OFF)
  6168.  
  6169. * Mouse Options window:
  6170.  
  6171.    - Left Button (SELECT RANGE)
  6172.    - Middle Button (NO OPERATION)
  6173.    - Right Button (NO OPERATION)
  6174.  
  6175. * Keyboard Options window:
  6176.  
  6177.    - Advance Line (DOWN)
  6178.    - Advance Track (DON'T ADVANCE)
  6179.    - Advance Cursor (DON'T ADVANCE)
  6180.    - Keypad Mode (TRACKS ON/OFF)
  6181.    - Keypad Mapping (ALTERNATIVE)
  6182.    - Space Value (2)
  6183.    - Chord Reset (ON)
  6184.    - Space = DEL (OFF)
  6185.    - Protracker Shortcuts (OFF)
  6186.    - Advance with sound (OFF)
  6187.    - Destructive Spacing (ON)
  6188.    - Auto-Round Spacing (ON)
  6189.  
  6190. * Palette window:
  6191.  
  6192.    - The color scheme (WORKBENCH COLORS)
  6193.    - Palette Type (8-Bit)
  6194.  
  6195. * Instr menu:
  6196.  
  6197.    - Automatic Flush (OFF)
  6198.    - Add Path (OFF)
  6199.    - Remove Path (OFF)
  6200.  
  6201. * Note killing options in the MIDI menu
  6202.  
  6203. * Settings menu:
  6204.  
  6205.    - Display Max Tracks (16)
  6206.    - Equalizers (both ON)
  6207.    - H -> B (ON)
  6208.    - Auto-Freeze Screen (OFF)
  6209.  
  6210. In  addition,  OctaMED  will  save  the  current window positions (both zoomed and
  6211. unzoomed) if you have moved them from their usual positions.
  6212.  
  6213. The default settings file name is "S:OctaMEDPro.config".
  6214.  
  6215.  
  6216. Tracker Modules
  6217.  
  6218. There is a substantial amount of information lost if you choose to save in Tracker
  6219. Module format.  This information is:
  6220.  
  6221. ** Synthetic, hybrid and MIDI instruments
  6222. ** Multi-octave samples (including ExtSamples)
  6223. ** Some block contents (no lines above 64, no tracks above 4, no notes above B-3)
  6224. ** Player commands 8, E and 10
  6225. ** Instruments above 0V
  6226.  * All instrument parameters apart from Repeat and RepLen (Loop On, Transpose, 
  6227.    Finetune, ** Hold and Decay, default volume, MIDI parameters)
  6228.  * Multi-modules (only the current song will be saved)
  6229.  * 5-8 channels
  6230.  * Song sections (converted to one playing sequence as described in the Save 
  6231.    Options Window)
  6232.  * MIDI Messages, the state of the MIDI Active switch
  6233.  * Relative track volumes
  6234.  * Block names
  6235.  * Line highlighting
  6236.  * Annotation text
  6237.  * Notation Editor data
  6238.  * Decimal / Hex Volumes (converted to hex volumes)
  6239.  
  6240. (The  information which is given in the requester brought up when trying to save a
  6241. Tracker module is marked above with a **).
  6242.  
  6243. Note  that the resulting file is a 31-instrument module, incompatible with Tracker
  6244. programs only supporting old 15-instrument modules.
  6245.  
  6246.  
  6247. Protracker commands
  6248. -------------------
  6249.  
  6250. Many  player  commands  are  converted  when  saving  Tracker  modules and loading
  6251. Protracker modules.  They are:
  6252.  
  6253.    OctaMED command | Protracker command
  6254.    ----------------+-------------------
  6255.          0D        |         A
  6256.          0FF8      |         E11
  6257.          0FF9      |         E12
  6258.          11        |         E1
  6259.          12        |         E2
  6260.          13        |         3
  6261.          14        |         4
  6262.          15        |         E5
  6263.          16        |         E6
  6264.          18        |         EC
  6265.          19        |         9
  6266.          1A        |         EA
  6267.          1B        |         EB
  6268.          1C        |         C    (saving only)
  6269.          1D        |         D
  6270.          1E        |         EE
  6271.          1F        | Digit 1 ED, digit 2 E9  (loading just converts ED)
  6272.  
  6273. When  loading,  commands E3 and E4 are ignored.  When saving, commands 8, E and 10
  6274. are ignored.
  6275.  
  6276.  
  6277. Hexadecimal Values
  6278.  
  6279. "Hexadecimal"  (or  "hex"  for  short)  is  basically  just  a  different   way of
  6280. representing  numbers.   It is more convenient for the computer because of the way
  6281. it works, and allows the user to specify a greater range of numbers using the same
  6282. amount of digits.
  6283.  
  6284. Hex values are used in the player commands, synth editor, the secondary tempo, and
  6285. the  MIDI  message  editor.    So  they're quite important in OctaMED (and also in
  6286. general computing).
  6287.  
  6288. In  the  usual decimal system, a digit can be ten different values: 0, 1, 2, 3, 4,
  6289. 5, 6, 7, 8 and 9.
  6290.  
  6291. In  the hex system, however, a digit may have sixteen values: 0, 1, 2, 3, 4, 5, 6,
  6292. 7,  8, 9, A, B, C, D, E and F.  The decimal numbers 10 - 15 are represented by the
  6293. letters A to F:
  6294.  
  6295.     Decimal 10  =  A
  6296.             11  =  B
  6297.             12  =  C
  6298.             13  =  D
  6299.             14  =  E
  6300.             15  =  F
  6301.  
  6302. With  two  digits  in  a  number,  the  decimal system can represent 10 × 10 = 100
  6303. different  values.    The hex system, however, can represent 16 × 16 = 256 values:
  6304. over twice the amount of the decimal system.  (The lowest number is 00 = zero, and
  6305. the highest number is FF = 255 decimal).
  6306.  
  6307.  
  6308. Converting between the two systems
  6309. ----------------------------------
  6310.  
  6311. So although it feels strange to work in at first, it has its advantages.  In a two
  6312. digit  hex  number (e.g.  8A), the first digit represents multiples of 16.  So, to
  6313. convert a two-digit hex number to decimal:
  6314.  
  6315.         Decimal number = (Hex digit 1) × 16 + (hex digit 2)
  6316.  
  6317. And  to  convert decimal to hex, divide the decimal number by 16.  The quotient is
  6318. hex digit 1, the remainder is hex digit 2.
  6319.  
  6320. For example:
  6321.  
  6322.     Hex 8A -> decimal:
  6323.  
  6324.              Hex digit 1 = 8, hex digit 2 = A (10).
  6325.  
  6326.              Decimal number = (8 × 16) + 10 = * 106 *.
  6327.  
  6328.     Decimal 200 -> hex:
  6329.  
  6330.              200 ÷ 16 = 12 remainder 8.
  6331.  
  6332.              Hex digit 1 = C (12), hex digit 2 = 8.
  6333.  
  6334.              So hex number = * C8 *.
  6335.  
  6336. Hex numbers are sometimes distinguished from decimal numbers by preceding hex with
  6337. a "$" sign.  For example: $C8, $FF.
  6338.  
  6339.  
  6340. Signed hexadecimal
  6341. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  6342. There  is a further complication!  Luckily in OctaMED you'll only need to use this
  6343. in  two  player  commands:  MIDI  command  3 (set pitchbender) and command 15 (set
  6344. finetune).
  6345.  
  6346. The  "sign"  of  a number denotes whether the number is positive or negative: that
  6347. is, the "+" and "-" signs.
  6348.  
  6349. In  hexadecimal,  however,  there  are  no  "-"  signs.   So, negative numbers are
  6350. represented by positive numbers (it will become clearer!).
  6351.  
  6352. In  signed  hex,  the  numbers $00 - $7F are positive as usual: they represent the
  6353. decimal  numbers  0  -  127.  However, the numbers $80 - $FF represent the decimal
  6354. values -1 to -128:
  6355.  
  6356.     Decimal   -1  =  $FF
  6357.               -2  =  $FE
  6358.               -3  =  $FD
  6359.               -4  =  $FC
  6360.              ...
  6361.              -16  =  $F0
  6362.              -17  =  $EF
  6363.              -18  =  $EE
  6364.              ...
  6365.             -126  =  $82
  6366.             -127  =  $81
  6367.             -128  =  $80
  6368.  
  6369. So to convert negative decimal numbers to signed hex numbers, first add 256 to the
  6370. number, then convert to hex as above.  For example:
  6371.  
  6372.     Decimal -67 -> signed hex:
  6373.  
  6374.              -67 + 256 = 189.
  6375.  
  6376.              189 ÷ 16 = 11 remainder 13.
  6377.  
  6378.              Hex digit 1 = 11 (B), hex digit 2 = 13 (C)
  6379.  
  6380.              So signed hex number = * $BC *.
  6381.  
  6382.  
  6383. Hex  numbers  will  crop  up in many areas of computing, so if you've never worked
  6384. with them before, it's advisable to get used to them!
  6385.  
  6386.